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This publication provides programmers and systems analysts 
with the basic principles and programming requirements for 
the System Monitor. The programming information given in- 
cludes the control cards required, the linkage sequences to 
Monitor routines and data fields, the messages produced by the 
Monitor, and the console inquiries accepted. 

The System Monitor provides control for the ibm 1410/7010 
Operating System by furnishing programmed transition between 
runs and between jobs, relocating programs, and assigning 
input/output units. The System Monitor consists of the Resident 
and Transitional Monitors, 1410-SV-962, and the Linkage Loader, 
1410-UT-963. 

The reader is assumed to have a basic knowledge of the ibm 
1410 and/or 7010 Data Processing Systems and to have read the 
publication IBM 1410/7010 Operating System; Basic Concepts, 
Form C28-0318. 

Note: The ibm 1302 Disk Storage Unit is now designated the 
ibm 2302 Disk Storage Unit; there has been no change in the unit 
itself, in the applications for which the unit may be used, or in 
the programming parameters used to specify those applications. 
The ibm 2302 Disk Storage Unit designation has been used in the 
text of this publication; programming parameters remain un- 
changed and refer to 1302. 
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The System Monitor 



Purpose of this Publication 

This publication describes use of the System Monitor 
to control the 1410/7010 Operating System. Informa- 
tion is included about the functions and components 
of the System Monitor and its relationship to the Op- 
erating System. The publication also gives instructions 
for writing programs to run under control of the Sys- 
tem Monitor. 

Purpose of the System Monitor 

The System Monitor controls the 1410/7010 Operat- 
ing System. Some of the functions that it performs for 
programs within the Operating System are: 

1. Assignment of input/output units 

2. Program loading, including relocation of pro- 
grams, and linkage between programs and sub-routines 
that were independently written and compiled 

3. Programmed transition from run to run and job 
to job 

The Operating System can provide, at the option of 
each installation, control facilities for ibm Tele-pro- 
cessing Systems. Detailed information concerning this 
type of application is contained in the publication 
IBM 1410/7010 Operating System; Tele-processing 
Supervisor, Form C28-0321. 

Prerequisite and Related Literature 

The publication IBM 14010/7010 Operating System; 
Basic Concepts, Form C28-0318, is a prerequisite. The 



reader is assumed to be familiar with both the termi- 
nology and concepts defined by that publication. 

For a disk-oriented 1410 or 7010 Data Processing 
System, the publication IBM 1301, Models 1 and 2, 
Disk Storage and IBM 2302, Models 1 and 2, Disk 
Storage with IBM 1410 and 7010 Data Processing 
Systems, Form A22-6788, is a prerequisite. 

Related literature includes the following publica- 
tions, which contain detailed information about the 
other elements and functions of the 1410/7010 Oper- 
ating System: 

System Generation, Form C28-0352 

Basic Input/Output Control System, Form C28-0322 

Tele-processing Supervisor, Form C28-0321 

Utility Programs, Form C28-0353 

Generalized Tape Sorting Program, Form C28-0354 

Random-Processing Scheduler, Form C28-0323 

Autocoder, Form C28-0326 

FORTRAN, Form C28-0328 

COBOL, Form C28-0327 

Operators Guide, Form C28-0351 

Generalized Sorting Program using IBM 1301/2302 

Disk Storage, Form C28-0404 
File Organization System for IBM 1301/2302 Disk 

Storage, Form C28-0405 
Support of IBM 1311 Disk Storage Drives Under 

the Operating System, Form C28-0402 
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System Monitor Concepts 



The System Monitor coordinates the functions of all 
Operating System components, including user-written 
programs operating under it. In this coordination, the 
System Monitor does the following: 

1. It reads and analyzes control cards that describe 
functions to be performed. 

2. It assigns input/output units. 

3. It reads programs from the card reader, tapes, or 
disk. These programs may be requested by control 
cards or by imbedded calls within programs. 

4. It relocates these programs to unused areas of 
storage, provides communication among program ele- 
ments, and loads the programs into storage. 

5. It turns processing control over to the programs 
in storage and receives control from them when they 
are completed. These dependent programs may be 
user-written programs or IBM-provided components of 
the Operating System. 

6. It handles all input/output operations for de- 
pendent programs. 

To perform these control functions, a part of the 
System Monitor, the Resident Monitor, stays in lower 
core storage at all times. The Resident Monitor loads 
programs into core storage, handles input/output, and 
controls end-of -program actions. 

The rest of the System Monitor and all other com- 
ponents of the Operating System are kept on tape or 
disk and are brought into core storage as required. 
The other parts of the System Monitor are: 

1. Transitional Monitor, which analyzes control 
cards and assigns input/output units 

2. Linkage Loader, which relocates programs and 
provides communication among independently com- 
piled program elements 

Programs compiled by the language processors are 
in relocatable format. Relocatable programs have been 
arbitrarily assigned locations by the language proces- 
sors or the programmer. The Linkage Loader (1) re- 
locates the addresses in the relocatable programs to 
core locations above the Resident Monitor, and above 
other programs that will be in storage below the pro- 
gram; or (2) relocates the addresses to installation- 
specified locations. After relocation, programs are in 
absolute format. The absolute addresses in these pro- 
grams are the addresses the programs will use when 
they are executed. 

The over-all operation of the System Monitor is 
shown in Figure 1. 
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Figure 1. Operation of the System Monitor 



Programs to be tested can be run under control of 
the System Monitor in the same way as fully tested 
programs. One or more Utility programs of the Oper- 
ating System can be run at selected points during pro- 
gram execution and/or at the end of program to dump 
core storage, tapes, or disk. 



Use of the System Monitor 

Five types of control information are supplied by the 
installation to the System Monitor: 

1. Monitor control cards. Monitor control cards are 
identified by mon$$ in columns 6 through 10. These 
cards initiate program execution, assign input/output 
units to programs, and supply certain information to 
the System Monitor. They are described in the section 
"Use of Transitional Monitor." 

2. Linkage Loader control cards. These cards se- 
lect the elements composing a program and control 
program relocation. They are described in the section 
"Use of Linkage Loader." 

3. Imbedded calls. These are requests coded in a 
dependent program to incorporate elements into the 
program. They are described in the section "Use of 
Linkage Loader." 

4. Linkage sequences. These are coding sequences 
within a dependent program that enable the program 
to use facilities of the Resident Monitor. Each se- 
quence contains a branch instruction and may also 
contain one or more fields of control information. The 
branch instruction gives control to a routine in the 
Resident Monitor. These sequences are described in 
the section "Use of Resident Monitor Functions." 

5. Console inquiries. These are control messages 
typed on the console printer by the operator. They are 
described in the section "Messages and Inquiries." 



Batch Processing 

A major advantage of the System Monitor is that it 
permits batching programs, that is, running programs 
in groups, with minimum operator intervention. Pro- 
gram batches are subdivided into jobs and runs. 

The day's work is divided into jobs. Each job con- 
sists of one or more program executions, called runs, 
plus control information. All programs in a job must 
have compatible input/output assignments. 

The usual job is a request for a program in absolute 
format, residing on tape or disk, plus the necessary 
control information and input data. 

However, almost limitless combinations of runs can 
be performed in a single job. For example, a job can 
include a compilation, relocation of all programs in 
the job, execution of programs to test them, use of 
one or more of the Utility Programs, and execution 
of one or more fully tested production programs. 

Programs in source language may just be compiled, 
or may be compiled and executed ( compile-and-go op- 
eration) within one job. However, if errors are found 
in compilation, the request for execution of the com- 
piled program will be automatically canceled. 



Program Construction 

For the Operating System, a program is constructed 
of one or more phases. Many programs will consist of 
only one phase. If a program is too large for storage, 
it must consist of several phases; the phases are exe- 
cuted in succession, with each phase partly or com- 
pletely overlaying the preceding phase. 

Each phase consists of one or more subprograms. A 
subprogram is the basic program unit with which the 
Linkage Loader performs its processing. 

For the purposes of the Linkage Loader, a subpro- 
gram begins with a title card and ends with a Ter- 
mination card. The cards between the title and Ter- 
mination cards contain the relocatable statements pro- 
duced by a language processor. ( See the section "Use 
of Linkage Loader" for a description of the title 
card. Termination cards are described in the section 
"Program Patching.") 

A subprogram can be an entire, self-contained pro- 
gram, or it can be a closed subroutine to be executed 
in conjunction with other subprograms to form a 
phase. 

The subprograms in a job may be in source lan- 
guage, requiring compilation, or in relocatable form. 
If a job contains more than one subprogram, it may 
contain a mixture of source and relocatable decks. In 
a job, a relocatable subprogram may accompany the 
control cards, or it may reside in a program library 
on tape or disk. In the latter case, the control cards 
must include a call for the subprogram, or another 
subprogram in the job must contain an imbedded call. 

Subprograms are divided into two types: primary 
and secondary. A primary subprogram has an initial 
entry point specified by its Termination card. A pri- 
mary subprogram may be a phase in itself or may 
form the nucleus for a group of subprograms to be 
made into a single, executable phase. A secondary 
subprogram does not have an initial entry point on its 
Termination card. Secondary subprograms may com- 
pose a complete phase or may be combined with a pri- 
mary subprogram to form a phase. 

In Autocoder, for example, the distinction between 
primary and secondary subprograms is based on the 
end or spend statements. If the programmer specifies 
an address in one of these statements, that address is 
used for the initial entry point of the subprogram, and 
the language processor informs the Linkage Loader 
that this is a primary subprogram. If the operand of 
the end or spend statement is blank, the language 
processor informs the Linkage Loader that this is a 
secondary subprogram. 

A program must contain at least one primary sub- 
program to establish the initial entry point for exe- 
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cution of the program. For a multiphase program, the 
first phase must include at least one primary subpro- 
gram. Succeeding phases may or may not contain pri- 
mary subprograms. If the succeeding phase is of an 
executable nature, the preceding phase must contain 
the linkage to initiate its execution. 

The initial entry point of a program phase is estab- 
lished by the Termination card of the first primary 
subprogram processed for that phase. The Linkage 
Loader ignores entry points specified in other Termi- 
nation cards processed within that phase. 



Communication Symbols 

The System Monitor enables use of symbolic refer- 
ences, called communication symbols, so that a sub- 
program can refer to a routine in another separately 
compiled subprogram and to parts of the Resident 
Monitor. 

The two types of communication symbols are: 

1. Linkage symbols, which are used for communi- 
cation between subprograms 

2. System symbols, which are used for communi- 
cation from a subprogram to routines or data fields of 
the Resident Monitor 

Autocoder includes language statements that direct- 
ly relate to the use of communication symbols. For 
the most part, cobol and Fortran automatically gen- 
erate these symbols as they are needed in a program. 



Linkage Symbols 

Linkage symbols are established by two types of 
cards: the title card at the beginning of a subpro- 
gram, and Definition cards included in a subprogram. 
(Autocoder includes the defin statement for the crea- 
tion of Definition cards.) 

Each time the Linkage Loader encounters one of 
these cards, it places into its symbol table the char- 
acters that have been declared as the linkage symbol 
and the relocated address assigned by the Linkage 
Loader to the symbol. For example, a title card de- 
clares a subprogram name as a linkage symbol, and 
the origin point of the subprogram (after relocation) 
becomes the address assigned to that linkage symbol. 
This procedure enables a subsequent subprogram to 
refer to a previously processed subprogram by the 
linkage symbol that is the previous subprogram's 
name. 

A linkage symbol can appear in a subprogram in 
either of two formats: 

1. A symbol consisting of one to ten characters, 



such as a subprogram name. The first character must 
be alphabetic; the remaining characters can be alpha- 
betic or numeric. No special characters can be used. 
If the symbol is less than ten characters, it is left- 
justified, with trailing blanks in a ten-position field. 

2. A five-character symbol consisting of four char- 
acters followed by a slash ( abcd/ ) . The first character 
must be alphabetic; the next three characters can be 
alphabetic or numeric. 

Reference to linkage symbols of the first format are 
made by dcws and dcwf cards, cobol and Fortran 
automatically generate these cards as needed. Auto- 
coder includes language statements for the generation 
of these cards. When the Linkage Loader encounters 
a dcws card, it puts into the subprogram a branch in- 
struction containing the address assigned to the link- 
age symbol in the dcws card. A dcwf card causes the 
Linkage Loader to put into the subprogram a five- 
character constant that is the address equated to the 
linkage symbol. 

Note: dcws and dcwf cards can contain only one- 
to ten-character linkage symbols. 

dcws and dcwf cards are termed imbedded calls be- 
cause they are requests for subprograms coded into 
a subprogram. 

References to linkage symbols of the abcd/ format 
can be made by using the symbol in the A-field or B- 
field of an instruction or by using the symbol as an ad- 
dress constant. For example, in the Autocoder lan- 
guage, the programmer can use the defin statement 
to declare work/ as a linkage symbol that represents 
the address of a work area. The programmer can then 
use work/ in the operand of an instruction that refers 
to that work area, such as s +io, work/. Such an in- 
struction can be included in any other subprogram 
processed by the Linkage Loader during the same run 
as the subprogram that declared the linkage symbol. 

Note that linkage symbols are designed for use as 
references between separately compiled subprograms. 
Each of the language processors provides facilities for 
references within a subprogram. 



System Symbols 

System symbols are defined by the System Monitor 
and require no declaration by subprograms. Subpro- 
grams need only refer to them. These symbols, given 
in the section "Use of Resident Monitor Functions," 
refer to routines and data in the Resident Monitor. 

All system symbols have the format /abc/. These 
symbols can appear in the operand of any instruction 
or as an address constant. The Linkage Loader con- 
verts all system symbols to actual addresses when it 
relocates the dependent programs. 



Listing of Communication Symbols 

The Linkage Loader produces a listing of all linkage 
symbols used during the processing of subprograms. 
Each symbol is listed with the core-storage address it 
represents. Thus, the listing shows the location of pro- 
gram elements after they have been relocated. 

For all system and linkage symbols that are not de- 
fined, the Linkage Loader will: 

1. Print all unresolved symbols. This list includes 



undefined communication symbols and all unfilled 
calls for subprograms. 

2. Leave undefined communication symbols in the 
instruction in which they appeared. 

The Linkage Loader will permit programs with un- 
defined communication symbols or unresolved calls to 
be executed; however, these programs will fail if exe- 
cution is attempted of an instruction containing an un- 
resolved call or undefined communication symbol. 
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Structure and Functions of the System Monitor 



Structure of the System Monitor 

The System Monitor consists of three major elements: 

1. Resident Monitor. This element contains the con- 
trol routines required while running dependent pro- 
grams and, therefore, remains in core storage at all 
times. 

2. Transitional Monitor. This element performs 
functions related to the transition from run to run and 
job to job. It is brought into storage by the Resident 
Monitor when transitional functions are needed. One 
of its major functions is the analysis and processing of 
Monitor control cards. 

3. Linkage Loader. This element performs the func- 
tions required to prepare relocatable programs for exe- 
cution. It is brought into storage by the Resident Mon- 
itor when requested by Monitor control cards. 

Functions of Resident Monitor 

Input/Output Control System 

The Input/Output Control System (iocs) is created 
during System Generation to meet the requirements of 
the installation. This iocs, termed the Resident IOCS, 
is in the Resident Monitor. It contains the basic rou- 
tines, such as those for error checking, that perform 
functions common to all input/output operations. ( For 
detailed information concerning the Resident iocs, see 
the publication Basic Input/Output Control System.) 

SPOOL Routines 

The Resident Monitor contains facilities for running 
card-to-tape, tape-to-card, and tape-to-printer opera- 
tions concurrently with dependent programs. This type 
of operation is called Simultaneous Peripheral Opera- 
tion On Line (spool). 

Unit-Record Routines 

The Resident Monitor contains three routines to han- 
dle input/output operations for unit-record equipment. 
One of these routines is for card input ( Read routine ) , 
another for card output ( Punch routine ) , and the third 
for printer output (Print routine). Each of these rou- 
tines has an alternate routine that performs the unit- 
record functions with magnetic tape. For each unit- 
record function, the installation can specify whether 
the function is to be performed with magnetic tape or 
unit-record equipment. 



Assignment Routine 

Facilities for assigning input/output units for program 
use are included in the Resident Monitor and the 
Transitional Monitor. The Resident Monitor contains 
tables of information about the installation's input/ 
output equipment, and facilities for providing this 
information as required during program execution. 
The Transitional Monitor analyzes control card infor- 
mation related to input/output assignment and co- 
ordinates this information with the Resident Monitor's 
Assignment routine. 

End-of-Program Routine 

The End-of-Program routine analyzes each end of pro- 
gram to determine the function to be performed next. 
If it is a normal end of program ( successful completion 
of the program being executed ) , the Transitional Mon- 
itor is brought into storage to process the Monitor 
control cards that define the next run. 

If the end of program is caused by program failure 
(unusual end of program), the End-of-Program rou- 
tine preserves the contents of core storage on tape, if a 
tape was provided for that purpose. The Transitional 
Monitor then processes the Monitor control cards for 
the next run, if the job or program is being tested, or 
skips to the control cards for the next job. 

A third type of end program, special end of pro- 
gram, is used by the Linkage Loader and the language 
processors to indicate that the contents of their output 
files are not valid. 

Load Routine 

The Load routine brings programs, which have been 
relocated and are ready for execution, into storage. 
These absolute-format programs are on the Job file 
produced by the Linkage Loader, or on the System 
Operating File. The Load routine loads from the file 
named in the Monitor control card that executes the 
program. (The files are discussed later in this section.) 
The Load routine also searches for phases required 
during the execution of a job. For example, this routine 
is used by one phase of a multiphase program to locate 
the next phase and bring it into storage. Each program 
phase, at its completion, specifies to the Load routine 
which phase is to be located next. Note that the next 
program phase need not be the next in numerical 
sequence. 
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For example, Phase 1 of a program could issue a re- 
quest for Phase 2 or any other phase, basing its choice 
on the result of the processing in Phase 1. Dependent 
programs may also use the subroutines of the Load 
routine to read, search, backspace, and rewind the file 
from which the program was loaded. 

Note: The Load routine cannot load the two high- 
est core -storage positions. The Operating System 
places group marks with word marks in the two high- 
est core-storage positions; these group marks with 
word marks must not be destroyed by dependent pro- 
grams. 

Communication Region 

The Communication Region is a collection of fields 
that contain control information. Some fields contain 
information used for communication among various 
ibm programs within the Operating System; others 
contain information of value to the user's programs. 
Some fields contain data; other fields contain addresses. 

For example, one Communication Region field con- 
tains the current date. This field can be addressed by 
any program. The Resident iocs uses this field to deter- 
mine the date for writing and checking tape labels. 
The user's programs can address this field for such pur- 
poses as creating a header record for printer output. 

Communication Region fields can be modified only 
through the Resident Monitor's Modification routine, 
which is described in the section "Use of Resident 
Monitor Functions." 

Wait-Loop Routine 

The Wait-Loop routine allows programs to suspend 
processing until the operator performs a specified func- 
tion, such as changing forms on the printer. A program 
can write a message on the console printer, branch to 
the Wait-Loop routine, and resume processing after 
the operator signals the Resident Monitor that the 
function specified by the message has been completed. 

Console Inquiry Routine 

Facilities for responding to console inquiries are in- 
cluded in both the Resident Monitor and the Transi- 
tional Monitor. The Resident Monitor accepts console 
inquiries during a run, such as a signal from the oper- 
ator to exit from the Wait-Loop routine. The Transi- 
tional Monitor accepts console inquiries between jobs, 
such as a signal to begin reading from the Alternate 
Input Unit. 

The Console Inquiry routines (in both the Resident 
and Transitional Monitors ) serve to communicate con- 
trol information to the System Monitor. Programs oper- 
ating under control of the System Monitor can also use 
the console printer for communication with the 
operator. 



Initialization Routine 

The Initialization routine performs housekeeping to 
prepare the System Monitor for work. This routine is 
at the top of the Resident Monitor area and is overlaid 
by the first dependent program brought into storage. 
The functions and use of the Initialization routine are 
explained in the publication Operator's Guide. 

Functions of the Transitional Monitor 

Control Card Interpretation Routine 

When the Transitional Monitor is brought into storage, 
one of its major functions is the interpretation of the 
Monitor control cards that define the next run or job. 
The Control Card Interpretation routine analyzes the 
Monitor control cards and, in accordance with their 
specifications, gives control to the System Monitor ele- 
ments required to prepare and execute the next run. 

Job Routine 

The Job routine prepares the Resident Monitor for the 
next job. This preparation includes resetting various 
program switches, clearing certain areas in the Com- 
munication Region, and canceling certain input/output 
unit assignments. 

Functions of the Linkage Loader 

The Linkage Loader converts relocatable subprograms 
into absolute format and, in the process, resolves com- 
munication symbols into machine addresses. 

Each Linkage Loader run produces a Job file, which 
contains program(s) in absolute format. Each program 
consists of all the subprograms to be executed as one 
program. A program on the Job file is brought into 
core storage by the Resident Monitor's Load routine 
when a Monitor control card requests execution of 
that program. 

The Linkage Loader chain feature permits the 
Linkage Loader to construct multiphase programs 
from programs compiled by the Fortran and cobol 
language processors, as well as by the Autocoder 
processor. 

Input to the Linkage Loader is from the Standard 
Input Unit, the Go file, and/or the System Library file. 
(These input/output files are discussed in the follow- 
ing topic, "Input/Output Files.") When several sub- 
programs are to be combined into a single program, 
the subprograms can be supplied to the Linkage 
Loader from any combination of the three input files, 
or they can all be from the same file. 

Selection of the subprograms to be converted into a 
single program is determined by control cards or by 
imbedded calls in the subprograms being processed. 
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The Linkage Loader has the ability to incorporate 
patches or Snapshot requests into a previously com- 
piled subprogram. 



Input/Output Files 

The input/output files for the Operating System and 
the dependent programs running under it are divided 
into five categories : 

1. System Files. These input/output files, described 
below, are used by the System Monitor. 

2. Work Files. These tape, disk, or unit-record files 
are used by Operating System programs and can be 
used by installation programs. The symbolic names for 
these files are: 

mwo ( mw-zero ) through MW9 
mwa through mwz 

3. Reserve Files. These tape, disk, or unit-record 
files are reserved for use by installation programs. The 
symbolic names for these files are: 

mro through MR9 
mra through MRZ 

4. Tele-processing System Files. These tape, disk, or 
unit-record files are used by dependent programs that 
operate under control of the Tele-processing Supervi- 
sor. The symbolic names for these files are: 

mto through MT9 
mta through MTZ 

5. SPOOL Files. These unit-record and tape files are 
used by card-to-tape, tape-to-card, and tape-to-printer 
programs that run concurrently with, but independ- 
ently of, other programs. The symbolic names for these 
files are: 

sui and sus ( unit-record files ) 
sti and st2 ( tape files ) 

System Files 

System Operating File (SOF) 

The System Operating File contains Operating System 
programs in absolute format. This file contains the Sys- 
tem Monitor and can contain the language processors, 
the Utility programs, and the Sort Definition program. 

The System Operating File is created at System Gen- 
eration and is constructed according to the program 
requirements of each installation. When the file is cre- 
ated, the user may add user-written programs, such as 
an inventory or payroll program. The System Opera- 
ting File may be on tape or disk. 

The first element of the System Operating File is the 
Bootstrap routine, which initially loads the Resident 
Monitor into core storage. The following elements are 
IBM-supplied and installation components of the Op- 
erating System. 



System Library File (LIB) 

An installation can have any number of libraries of re- 
locatable programs, but only one is designated as the 
System Library file for a particular run of the Linkage 
Loader. 

A library may be on tape or disk. If it is on tape, it 
can be on the same tape as the System Operating File 
or it can be on a separate reel. The System Operating 
File tape can contain several libraries. If a library is on 
a separate tape, this tape can contain only one library. 

Libraries are created through use of the System 
Generation maintenance programs. (See the System 
Generation publication. ) 

Standard Input Unit (SIU) 

The Standard Input Unit contains the file of control 
information for the System Monitor. Source programs 
for the language processors, relocatable programs to 
be processed by the Linkage Loader, and data and 
control cards for dependent programs may also be 
placed in the Standard Input Unit. The Standard 
Input Unit can be a card reader or a magnetic tape 
unit. If it is a magnetic tape unit, the tape must be 
written in odd parity. 

Note: The term card means one 80-character input 
record. This record can be read either from an actual 
card, in installations that use a card reader for the 
Standard Input Unit, or it can be a tape record of 80 
characters. Tape files consisting of this type of record 
are said to be in card-image format. 

Alternate Input Unit (AIU) 

At the option of each installation, capability for using 
the Alternate Input Unit may be specified at System 
Generation. Control information can then be submitted 
to the System Monitor through either the Alternate or 
the Standard Input Unit. This configuration permits a 
high-priority job in the Alternate Input Unit to break 
into the previously established sequence of jobs in the 
Standard Input Unit. 

The Alternate Input Unit can be a card reader or a 
magnetic tape unit; it may be the same type of unit as 
the Standard Input Unit or it may be different. The 
type of unit for the Alternate Input Unit can be 
changed by a Monitor control card. 

Requests for changing from the Standard Input Unit 
to the Alternate Input Unit can be made between jobs 
through a console inquiry. 

Standard Print Unit (SPR) 

The Standard Print Unit is used for all printer output 
from ibm programs within the Operating System. 
Diagnostic messages for the programmer are written 
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on this unit. It can also be used by the installation's 
programs. 

The Standard Print Unit can be either the ibm 1403 
Printer or a magnetic tape unit. If it is a tape unit, it 
can be the same unit as the Standard Punch Unit, 
which is described below. If the user specifies the 
variable print and punch modules at System Genera- 
tion, the Standard Print Unit can be on the same 
tape unit as the Core Image file, the Temporary Stor- 
age file, and the Standard Punch Unit. (See "System 
File Sharing and Device Switching Feature.") 

The Standard Print Unit can be omitted from a sys- 
tem; however, omission means that the programmer 
will not receive diagnostic messages or language proc- 
essor listings. 

Standard Punch Unit (SPU) 

The Standard Punch Unit is used for all punched-card 
output from ibm programs within the Operating Sys- 
tem. It is also available for use by the installation's 
programs. 

The Standard Punch Unit may be either the ibm 
1402 Card Read Punch or a magnetic tape unit. If it is 
a tape unit, it can be the. same unit as the Standard 
Print Unit. If the variable print and punch modules 
are selected, the Standard Punch Unit can be on the 
same tape unit as the Core Image file, the Temporary 
Storage file, and the Standard Print Unit. This unit 
can be omitted from a system. 

When the Standard Punch and /or Standard Print 
Units are tape, the pow program can be used on an 
ibm 1401 to print and/or punch the tape records. 
When use of the pow program is specified at System 
Generation, the Transitional Monitor writes the pow 
program as the first record on the tape when the tape 
is opened, either during initialization of the system or 
at the direction of the operator. (The pow program is 
described in the Operators Guide publication.) 

Job File (MJB) 

The Job file is the output file of the Linkage Loader. It 
contains programs in absolute format. Job file pro- 
grams are loaded into storage by the Resident Moni- 
tor's Load routine. 

The Job file must be assigned to the same type of de- 
vice (tape or disk) as the System Operating File. 

Go File (MGO) 

The Go file contains relocatable programs compiled by 
the language processors. The Go file may contain one 
or more relocatable subprograms that were output 
from one or more language processor runs in the same 



job. The Go file serves as one of the input sources for 
the Linkage Loader. 

The Go file may be on tape or disk, as specified for 
each language processor during System Generation. 

Core Image File (MDM) 

The Core Image file is used by the Resident Monitor 
to record the status of core storage at particular times 
during processing. This file is used by the Resident 
Monitor's End-of-Program routine each time an un- 
usual end of program occurs. (The records written by 
the End-of-Program routine can later be used as input 
to the Utility program's Storage Print program, which 
edits and writes them on the Standard Print Unit. ) 

The Core Image file serves programs that use the 
iocs macro-instruction for writing checkpoint records. 
Checkpoint records can be used to restart a program 
that was temporarily interrupted. 

The Core Image file can also be used by dependent 
programs to log read errors. (See the Basic Input/ 
Output Control System publication. ) 

Use of the Core Image file is optional, but if it is in- 
cluded in an installation, it must be assigned to a tape 
unit. If the variable print and punch modules are se- 
lected, the Core Image file can be on the same tape 
unit as the Standard Print Unit, Standard Punch 
Unit, and the Temporary Storage file. 

TP Library (MLT) 

The tp Library file consists of the tp programs and a 
tp Directory; the latter speeds the locating and load- 
ing of the tp programs. 

The tp Library file may be on either disk or tape. 
However, if the file is on tape, it must be the only 
file on that tape. 

Temporary Storage File (MDT) 

The Temporary Storage file is used if there is insuffi- 
cient core storage available for a tp program. If a tp 
program extends beyond the area reserved for it, the 
Tele-processing Supervisor (provided that requisite 
modules have been included, at System Generation 
time) unloads the main-line program onto the Tem- 
porary Storage file, to make the required area avail- 
able. When it is time to return control to the main-line 
program, the Supervisor reloads the program from the 
Temporary Storage file. 

If the variable print and punch modules are select- 
ed, the Temporary Storage file can be on the same 
tape unit as the Standard Print Unit, the Standard 
Punch Unit, and the Core Image file; however, if the 
variable modules are not selected, the Temporary 
Storage file cannot share a tape unit. 
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Use of Linkage Loader 



The output from each of the language processors is in 
relocatable format to permit subprograms to be as- 
signed to any available area of core storage. The 
Linkage Loader assigns a subprogram to a particular 
area of storage in accordance with three factors: 

1. The size of the installation's Resident Monitor 

2. The size and relative location of any other sub- 
programs to be loaded at the same time 

3. Control information specifying predetermined 
storage assignments 

Subprograms are compiled with address assign- 
ments relative to Absolute Zero (machine location 
00000). That is, program instructions are compiled by 
the Autocoder and cobol language processors, from 
location 00000 upward or, by the Fortran processor, 
from location 00001 upward. The Autocoder processor 
can also compile from the origin point specified by 
an org card. 

Subprograms are relocated by the Linkage Loader 
relative to an address in core storage called Base Zero. 
Base Zero is the address of the location immediately 
above the last location occupied by the installation's 
Resident Monitor minus its Initialization routine. ( For 
installations that permanently reserve an area above 
the Resident Monitor for programs within a Tele- 
processing system, Base Zero is the location im- 
mediately above that reserved area.) Base Zero is, 
therefore, the lowest location available to dependent 
programs. Figure 2 illustrates the relationship of 
Absolute Zero and Base Zero. 



Absolute 
Zero 



Base 
Zero 



Resident 



Monitor 



Subprogram Area 



Figure 2. Relationship of Base Zero to Absolute Zero 

When a subprogram is processed by the Linkage 
Loader, the subprogram's origin point is relocated in 
accordance with the installation's Base Zero. If, for 
example, the installation's Resident Monitor ended 



at location 10000, the Linkage Loader assigns an 
actual origin point of 10001 to the first subprogram it 
processes. Other addresses contained in the sub- 
program are relocated accordingly. 

This type of relocation is termed upward relocation. 
Upward relocation is applied to the load addresses as- 
signed by the language processor to locate instructions 
and areas in core storage and to the reference ad- 
dresses in the A-fields and B-fields of the subprogram's 
instructions. Thus, the subprogram can be assigned to 
any area of core storage, yCt interrelationship of the 
subprogram's elements is maintained. 

Note: The Linkage Loader will not permit a de- 
pendent program to overlay the Resident Monitor. If 
a load address, after relocation, is below Base Zero, 
the Linkage Loader will stop processing the program 
and will return control to the Resident Monitor. The 
Resident Monitor will bring in the Transitional Mon- 
itor, which will resume processing with the next job. 

Upward relocation is the most common type of 
relocation used for a subprogram. However, the 
Linkage Loader performs two other types of relocation 
within subprograms. 

One of these is downward relocation. Where sepa- 
rately compiled subprograms are to share data areas, 
common data areas are used. These areas are located 
at the top of storage or at addresses specified by the 
programmer. Normally the specified address should be 
near the top of storage. The common data areas are 
addressed at the high-core-storage position. When 
assigning addresses to common data areas, the lan- 
guage processors arbitrarily designate 99999 as the 
top of storage. The Linkage Loader then relocates the 
addresses downward to the actual top of storage or 
to the specified location. 

The third type of relocation is NO relocation. The 
Linkage Loader does not relocate certain fixed ad- 
dresses, such as index register addresses. 

The value used by the Linkage Loader to perform 
upward relocation is called the upward relocation 
factor. For the first subprogram in core storage, the 
relocation factor is equal to Base Zero; for succeeding 
subprograms in the same phase, the relocation factor 
is equal to Base Zero plus the size of all preceding 
subprograms in that phase. 

The subprograms that form a given phase can be in 
any order in core storage; a primary subprogram need 
not be the first. 



14 



Note: During compilation, a character must be 
placed in the highest location of a subprogram. (That 
is, a subprogram cannot end with an area into which 
nothing is loaded, such as an area defined by an Auto- 
coder da statement that does not set a group mark 
with work mark in its highest position.) Some char- 
acter is necessary in the subprogram's highest location 
to enable the Linkage Loader to properly relocate any 
following subprograms. 

This requirement is automatically satisfied by the 
cobol and Fortran language processors. The require- 
ment can be met for an Autocoder compilation by a 
statement that defines a one-character constant in the 
subprogram's highest location. 



Control Cards for the Linkage Loader 

Control cards for the Linkage Loader direct processing 
during one execution of the Linkage Loader, rather 
than directing the general flow of processing during a 
batch. Linkage Loader control cards are not Monitor 
control cards; that is, they do not contain the identi- 
fication MON$$. 

The Monitor control card that initiates execution of 
the Linkage Loader must immediately precede the 
control cards for the Linkage Loader. The Linkage 
Loader determines that it has come to the end of its 
control cards when it finds a card that is not in a 
format it recognizes. This card must be a Monitor 
control card. 

Figure 3 lists the Linkage Loader control cards, 
summarizes the important information about them, 
and shows their formats. 

CALL Card 

The operand of the call card is the name of the sub- 
program to be processed by the Linkage Loader. This 
card is used to request a subprogram from the System 
Library file or the Go file. A subprogram in the Stand- 
ard Input Unit does not require a call card; its title 
card serves the same function. When the Linkage 
Loader encounters a call card, it adds the specified 
name to a list of requests. When the Linkage Loader 
is ready to begin processing the subprograms on this 
request list, it searches for them first in the Go file 
and then in the System Library file. 

This search is performed by reading the names of 
the programs on the Go file and the System Library 
file and comparing them with the names on the re- 
quest list. This technique minimizes the time required 
for searching. 

Because the Linkage Loader uses this technique to 
minimize search time, the final sequence of subpro- 



grams in core storage is not necessarily the same as 
the call cards that requested the subprograms. (The 
calln and callp cards, described later, can be used 
to control the relative positioning of subprograms in 
core storage. ) 

For example, assume that the following subpro- 
grams are arranged sequentially on the System Library 
file: spi, sps, SP3, SP4, and sps. Assume also that call 
cards were read from the Standard Input Unit in the 
order: call sp3, call spi, call sp4. The Linkage 
Loader begins its search of the System Library file 
and locates the title card for spi. It checks this name 
against the names on the request list and finds that 
there is a request for spi; therefore, it processes spi 
and places it on the Job file. The Linkage Loader then 
searches forward in the System Library file and locates 
the title card for SP2. It checks the request list, finds 
no request for sps, and continues the search. The title 
card for SP3 is found in the Library and checked 
against the list. The Linkage Loader finds a request 
for sps and, therefore, processes it and places it on the 
Job file behind spi. This procedure continues until all 
the subprograms on the request list have been located, 
processed, and placed on the Job file. 

The final sequence of subprograms would be spi, 
SP3, SP4 — the order in which they were located on 
the Library. (The relative location of subprograms in 
storage is referred to as the memory map.) The relo- 
cation factor for the three subprograms was adjusted 
as follows: spi was given an origin point of Base Zero, 
and all upward relocation for spi was performed with 
a relocation factor equal to Base Zero; SP3 was given 
an origin point of Base Zero plus the size of spi, and 
all upward relocation for SP3 was performed with a 
relocation factor equal to Base Zero plus the size of 
spi; SP4 was given an origin point of Base Zero plus 
the combined size of spi and SP3, and all upward 
relocation for sp4 was performed with a relocation 
factor equal to Base Zero plus the combined size of 
spi and SP3. 

Imbedded Calls 

In addition to requests for subprograms specified by 
call cards, Autocoder language dcws, dcwf, and call 
cards are requests for subprograms. Because these 
cards are within subprograms, this type of request is 
termed an imbedded call. 

When the Linkage Loader encounters an imbedded 
call, it checks its symbol table for the name of the 
called subprogram. If it finds the name, the sub- 
program has already been processed, since its title 
card established the name as a linkage symbol. Then 
the Linkage Loader replaces the imbedded call, for a 
dcws card, with a branch to the address assigned to 
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Location in 
Control Card 
Deck 



Beginning of first 
phase in program 



Beginning of 
succeeding phase 



Beginning of 
succeeding phase 
(user-specified 
phase number) 
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005 



Immediately before 
BASE1 or PHASE 
card; anywhere 
within a subprogram 
except between TITLE 
and BASE! cards 



Immediately after 
TITLE card (if sub- 
program is on System 
Library file and is to 
be relocated to same 
point each time) or 
immediately after 
PHASE card or 
PHASE and PRTCT 
cards 



Within control cards 
for a phase or within 
a subprogram 



Within control cards 
for a phase 



Within control cards 
for a phase 



Before subprogram 
affected is processed or, 
within a subprogram, 
after TITLE card, but 
before any cards re- 
ferring to common data 
area 



First card of 
subprogram 



Format 

16 Card 20 
Type 



PHASE 



PHASE 



PRTCT 
PRTCT 
PRTCT 
PRTCT 



BASE1 
BASE1 
BASE1 



BASE1 



BASE1 



CALL 



CALLN 



CALLP 



BASE2 
BASE 2 
BASE2 



BASE2 



TITLE 



Figure 3. Control Cards for Linkage Loader 



21 Operand(s) 



PHASE PROGMNAME1 



LINKSYMBOL 

ABCD/ 

15000 



LINKSYMBOL 

ABCD/ 

15000 



'+X00 



SUBPGNAME2 



SUBPGNAME2 



SUBPGNAME2 



LINKSYMBOL 

ABCD/ 

15000 



SUBPRGNAME 
xxxxx 

yyyyy 

NOTE: Leave 
five blanks 
between xxxxx 
and yyyyy- 



Functions 



Terminates the previous phase, be- 
gins a phase, causes all previous 
calls to be processed. Defines 
PROGMNAME1 as the name of 
the program. 



Keeps Linkage Loader from 
erasing linkage symbols with 
addresses equal to or higher than 
operand. Blank-operand card 
removes the protection. 



Replaces current relocation 
factor with address for the link- 
age symbol or with absolute 
address in operand. 



Sets current relocation factor 
to next higher address that is a 
multiple of 100. 



Sets relocation factor to Base Zero. 



Calls subprogram from System 
Library or Go file when all calls 
are collected. 



Causes all previous calls to be 
processed, then brings in called 
subprogram from System Library 
or Go file. 



Causes all previous calls to be 
processed, then brings in called 
subprogram from System Library 
or Go file and adds patches to 
called subprogram. 



Sets upper limit of common data 
area to address for the linkage 
symbol or to absolute address in 
operand. 



Sets upper limit of common 
data area to top of core. 



Begins a subprogram. Defines 
SUBPRGNAME as linkage symbol . 

xxxxx=Origin for subprogram 
expressed as an absolute address. 

yyyyy=Size of common data area 
Autocoder subprogram will use. 



Remarks 



Erases I inkage symbols from Linkage 
Loader symbol table. Resets the 
downward relocation factor (see 
BASE2 card) to the top of core 
storage minus two. 
Columns 60 through 70 must be 
blank. . 



User specification of succeeding 
phase number, which must be 
in ascending order, need not be 
sequential', and may not be 
blanks or 999. Columns 60 
through 70 must be blank. 



Protection is changed by another 
PRTCT card and is effective only 
for the current Linkage Loader 
run. 



Erases from Linkage Loader 
symbol table linkage symbols 
with a value equal to or 
higher than the BASE1 value 
but less than PRTCT value. 



Cannot be used in System 
Generation mode of operation. 



Patch cards must immediately 
follow CALLP card. (See 
"Program Patching" section 
for patch card formats.) 



This downward relocation factor ap- 
plies to all succeeding subprograms 
during the current Linkage Loader 
run or until the next BASE2 card. A 
PHASE card with a name in the oper- 
and resets the downward relocation 
factor to the top of core storage 
minus two. 



NOTE: This TITLE card format 
is in the relocatable object 
deck produced by the language 
processors and may contain 
additional operands not used by 
the Linkage Loader; it is not the 
same format as the Autocoder 
symbolic TITLE card. 
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Location in 
Control Card 
Deck 


Format 


Functions 


Remarks 


6 15 


16 Card 20 
Type 


21 Operand(s) 


Within a 
subprogram 


ABCD/ 

LINKSYMBOL 

LINKSYMBOL 

LINKSYMBLl 

ABCD/ 


DEFIN 
DEFIN 
DEFIN 
DEFIN 
DEFIN 


LINKSYMBOL 
15000 
ABCD/ 
LINKSYMBL2 

WXYZ/ 


Defines the linkage symbol 
in columns 6 through 15 for 
use by the Linkage Loader 
as an entry point or data 
field within a subprogram. 


Can be coded directly in the 
Autocoder language. See the 
Autocoder publication for 
full details. 


After subprogram 
requested but be- 
fore the Linkage 
Loader symbol 
table is erased and 
before the end of 
the phase 


IDE NT 


SNAP 


SUBPGNAME2 
xxxxxyyyyy 
zzzzzyyyyy 
zzzzzss 

NOTE 1 : Do not 
put commas be- 
tween operands. 

NOTE 2: ss must 
be in columns 
56 and 57. 
Therefore, if only 
one area is to be 
snapped, leave 
blanks for the 
second 
yyyyyzzzzz . 


Requests Snapshots of storage 
during execution of the sub- 
program. Causes all previous 
calls to be processed. 
IDENT is any one to five char- 
acters to identify the 
Snapshot listing, 
xxxxx = Relocatable address 
of instruction before which 
the Snapshot is to be 
taken , 
yyyyy = Relocatable address of 
lower limit of area to be 
snapped . 
zzzzz = Relocatable address of 
upper limit of area to be 
snapped. 
ss = Length of instruction 
at xxxxx; if the instruction 
length is less than ten, it 
should be written with a 
zero in column 56. 


Cannot be used in a compile- 
and-go operation. 

Instruction before which 
Snapshot is to be taken must 
be at least seven characters 
long, cannot be chained, and 
cannot be in an IOCS macro- 
instruction. 

NOTE: When relocating the ad- 
dresses on the SNAP card, the 
Linkage Loader will add the 
value for the subprogram name 
linkage symbol to the relocatable 
addresses in the SNAP card. 
Therefore, if the subprogram 
was origined at other than 00000, 
subtract the origin value from 
the compiled addresses to get 
the addresses to be used on the 
SNAP card. 


Anywhere within 
control cards for 
Linkage Loader 




INPUT 
INPUT 


Mxx 
SIU 


Directs Linkage Loader to read 
control cards from a unit other 
than the one being read. 


Mxx is the name of a currently 
assigned symbolic unit, such as 
MR1 . End of file on the substitute 
unit causes a return to the 
Standard Input Unit, as does an 
INPUT card with the operand 
SIU. (See the section "Assign- 
ment of Input/Output Units.") 


Before CALLN, 
CALLP, PHASE, SNAP, 
01 Monitor control cards 
or end of file on Standard 
or Alternate Input Unit 




DISGO 




Go file will not be searched 
for subprograms. 


Effective during current Linkage 
Loader run or until next 
CONGO card. 


Anywhere after 
DISGO card 




CONGO 




Cancels DISGO card function. 




PROGMNAME1 is the linkage symbol that is the program name defined by the PHASE card. 
SUBPGNAME2 is the linkage symbol that is the subprogram name defined by the TITLE card. 
LINKSYMBOL is any linkage symbol. 

All three of these linkage symbols consist of one to ten characters that are left-justified, with trailing blanks in a ten-position field. 
ABCD/ is any five-character linkage symbol. 



Figure 3. Control Cards for Linkage Loader ( Continued ) 
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the linkage symbol or, for a dcwf card, with a five- 
character constant of that address. 

If the called subprogram has not yet been processed, 
the Linkage Loader places the subprogram name on 
its request list. ( The same request list is used for call 
card requests. ) When the Linkage Loader later locates 
and processes the subprograms on this list, it supplies 
the previous imbedded calls with the branch addresses 
or constants. 

Note 1 : Autocoder provides the defin statement for 
establishing linkage symbols to represent any point in 
a subprogram. ( The linkage symbol established by the 
title card of a subprogram represents the origin point 
of that subprogram. ) Linkage symbols established by 
the defin statement can also appear in dcwf and dcws 
cards; these cards are treated by the Linkage Loader 
in the same manner as dcwf and dcws cards that 
contain a subprogram name. However, note that a 
subprogram is located and processed only if it has 
been called by the name contained in its title card. 
Therefore, if subprogram anyname contains an entry 
point represented by the linkage symbol abcdefghij, 
the card dcws abcdefghij cannot be completely proc- 
essed unless a call has been made for anyname, either 
by a call card or an imbedded call. 

Note 2: The linkage symbols established within a 
particular phase of a multiphase program can be re- 
ferred to by subprograms within the same phase and 
succeeding phases, but they cannot be referred to in 
preceding phases. For example, Phase 1 cannot contain 
a dcws card with the linkage symbol work/ if that 
symbol is not established by a title card or Definition 
card until Phase 2. 

Organization of programs should be planned with 
special care regarding imbedded calls. Imbedded 
calls, if not ordered properly, could cause additional 
searches of the System Library file and, therefore, be 
time consuming. 

The following rules apply to calling programs : 

1. Rules of precedence for memory maps are: 

a. The first subprograms in core storage will be 
those read from the Standard Input Unit (in the 
order read ) . 

b. The second group of subprograms in core stor- 
age will normally be those read from the Go file 
( in the order read ) . 

c. The third group of subprograms in core stor- 
age will normally be those read from the System 
Library file ( in the order read ) . 

d. If the subprograms in items b and/or c con- 
tain imbedded calls, then item c will be repeated 
until all calls are completed. The Go file is not 
searched again. 

2. Imbedded calls are considered to be for subpro- 



grams in the System Library file. If the subprogram 
requested by an imbedded call is on the Go file, it 
must also be requested by a call card that is not 
imbedded in a subprogram. 

Note: The call card may be omitted if the re- 
quested subprogram follows the requesting subpro- 
gram on the Go file. 

3. The Go file is reset to its beginning and searched 
if any subprogram names are on the request list when 
the Linkage Loader reads a calln, callp, phase, 
snap, or Monitor control card, or finds the end of file 
on the Standard or Alternate Input Unit. 

Note: The disgo card can be used to prevent this 
search of the Go file. 

4. Subprograms placed in the Standard or Alternate 
Input Unit do not require a call card; their title 
cards serve this function. 

5. If a subprogram on the Go file is to replace a 
subprogram with the same name on the System Li- 
brary file and the subprogram is requested by an 
imbedded call, a call card should be used to guar- 
antee loading the subprogram from the Go file. 

Example 1 

This example illustrates the procedure for directing the 
Linkage Loader to process a subprogram from the Sys- 
tem Library file. The subprogram (spi) constitutes a 
self-contained, single-phase program that has no im- 
bedded calls for other subprograms. 

Only one control card is necessary: call spi. The 
Linkage Loader will locate spi on the Library, process 
it, and place it on the Job file. 

Example 2 

This example illustrates the procedure for directing 
the Linkage Loader to construct a single-phase pro- 
gram from three subprograms: spi, sp2, and SP3. (One 
of the three must be a primary subprogram; the other 
two can be primary or secondary.) In this example, 
spi is on the System Library file, sp2 is in the Standard 
Input Unit, and sp:5 is on the Go file. None of the 
subprograms contain imbedded calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 

CALL SPI 

title card and relocatable object deck for SP2 

CALL SP3 

The Linkage Loader proceeds as follows: 

1. call spi : The name of spi is placed on the re- 
quest list. 

2. title card and relocatable object deck for sp2: 
sp2 is processed and the name sp2 is added to the re- 
quest list, with a flag indicating that sp2 has been 
processed. 
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3. call SP3: The name SP3 is added to the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no more Linkage 
Loader control cards. It begins searching the Go file, 
locates SP3, and processes it. Next, the Library is 
searched, spi is located and processed. 

The memory map is shown below. The area between 
the outer vertical lines represents the area of core 
storage used for the subprograms processed. 



SP2 


SP3 


SPI 



Example 3 

This example illustrates the construction of a single- 
phase program from three subprograms, one of which 
is processed because of an imbedded call, spi is on the 
System Library file and contains an imbedded call for 
SP3; sp2 is on the Go file. 

The sequence of cards in the Standard Input Unit 
is as follows: 

CALL SPI 

CALL SP2 

The Linkage Loader proceeds as follows: 

1. call spi: The name spi is placed on the re- 
quest list. 

2. call SP2: The name SP2 is placed on the re- 
quest list. The Linkage Loader resumes reading from 
the Standard Input Unit and finds no more Linkage 
Loader control cards. It begins searching the Go file, 
locates SP2, and processes it. Next, the Library is 
searched, spi is located and processed. During the 
processing of spi, the Linkage Loader finds the im- 
bedded call for SP3. At that time, the name SP3 is 
placed on the request list. When the processing of spi 
is completed, the Linkage Loader checks the request 
list, finds the unsatisfied request, and resumes the 
search of the Library, sps is located and processed. 

The memory map is as follows: 



SP2 


SPI 


SP3 



CALLN Card 

The function of the calln (Gall Now) card is essen- 
tially the same as the call card, except that the calln 
card directs the Linkage Loader to locate and process 
the specified subprogram immediately. This card can 
be used to control the memory map. 

When the Linkage Loader reads a calln card, it 
does the following: 

1. All subprograms specified by previous call cards 
are located and processed. 

2. Any imbedded calls resulting from processing 
these subprograms are also processed (except im- 



bedded calls for the subprogram named in the calln 
card ) . 

3. Then the subprogram specified by the calln card 
is processed. 

4. Any imbedded calls resulting from processing the 
subprogram specified by the calln card are added to 
the request list for subprograms (if the imbedded 
calls have not been satisfied by processing already 
performed ) . 

The following rules apply to the use of the calln 
card: 

1. Rules of precedence for memory maps: 

a. All subprograms called before the subpro- 
gram named by the calln card will be the first 
subprograms in core storage. (The relative order 
of those subprograms is determined in accord- 
ance with the rules of precedence for the calln 
card. ) 

b. The subprogram named by the calln card 
will be placed in core storage following the sub- 
programs specified in item a, above. 

2. The name of a subprogram on the Standard 
Input Unit should never be the operand of a calln 
card. If the preceding calls should be processed be- 
fore a subprogram on the Standard Input Unit, the 
calln card should be used to call the last preceding 
subprogram. 

Example 7 

This example illustrates the construction of a single- 
phase program from four subprograms that must be 
positioned in a certain order. Three subprograms are 
on the System Library file and the fourth is in the 
Standard Input Unit. None of them contain imbed- 
ded calls. The sequence of subprograms on the 
Library is spi, sp2, sp3; sp3 must be positioned in 
storage after spi and before SP2 and SP4. 

The sequence of cards in the Standard Input Unit 
is as follows: 



CALL 
CALLN 



SPI 
SP3 



CALL SP2 

title card and relocatable object deck for SP4 
The Linkage Loader proceeds as follows: 

1. call spi: The name spi is placed on the re- 
quest list. 

2. calln SP3: The name SP3 is stored, but not 
placed on the request list. The Linkage Loader be- 
gins searching for previously called subprograms. It 
locates spi on the Library and processes it. The Link- 
age Loader then determines that the request list has 
been satisfied, (spi was the only name on the list.) 
The name SP3 is moved to the request list. SP3 is then 
located and processed. 
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3. call SP2: The name sp2 is placed on the re- 
quest list. 

4. title card and relocatable object deck for SP4: 
The Linkage Loader processes SP4. It resumes reading 
from the Standard Input Unit and finds no further 
Linkage Loader control cards. SP2 is then located and 
processed. 

The memory map is as follows: 



SPl 


SP3 


SP4 


SP2 



Example 2 

This example illustrates the construction of a single- 
phase program from three subprograms, one of which 
contains an imbedded call for a subprogram that 
must be placed between the other two subprograms. 

The three subprograms are on the System Library 
file in the order spi, SP2, sp3. sp3 must be positioned 
after spi and before SP2; spi contains an imbedded 
call for SP3. 

The sequence of cards in the Standard Input Unit 
is as follows: 



CALL 
CALLN 



SPI 
SP3 



CALL SP2 

The Linkage Loader proceeds as follows: 

1. call spi: The name spi is placed on the re- 
quest list. 

2. calln SP3: The name SP3 is stored but not 
placed on the request list. The Linkage Loader be- 
gins searching for previously called subprograms. It 
locates spi on the Library and processes it. During 
the processing of spi, the Linkage Loader finds the 
imbedded call for sp3. The Linkage Loader will sup- 
ply the imbedded call in spi with the address of SP3 
when the title card of SP3 is processed. The Linkage 
Loader then determines that there are no more names 
on the request list, moves SP3 to the request list, lo- 
cates SP3, and processes it. 

3. call SP2: The name SP2 is placed on the re- 
quest list. The Linkage Loader resumes reading from 
the Standard Input Unit and finds no more Linkage 
Loader control cards. SP2 is then located and pro- 
cessed. 

The memory map is as follows: 



SPl 


SP3 


SP2 



CALLP Card 

The callp (Call and Patch) card functions in the 
same manner as the calln card. The callp card also 



directs the Linkage Loader to incorporate patches 
into the specified subprogram. The patches, in relo- 
catable machine-language form, must immediately 
follow the callp card in the Standard Input Unit. 
(See the section "Program Patching" for patch card 
formats. ) 

PHASE Card 

phase cards are used to create a multiphase program 
and to assign a name to that program. .Each time the 
Linkage Loader encounters a phase card it performs 
the following functions: 

1. All previous calls (from both control cards and 
imbedded calls) are processed. The Linkage Loader 
gives the resulting phase a termination record, which 
indicates the entry point of that phase if it included 
a primary subprogram. (This information is used by 
the Load routine of the Resident Monitor to initiate 
execution of the phase after it has been loaded into 
core storage.) 

2. The Linkage Loader creates a header record for 
the next phase, consisting of the name and number of 
the phase. 

The first phase card for a multiphase program must 
specify the name of that program. Succeeding phase 
cards for the same program must have blank operand 
fields. For the first phase card, the Linkage Loader 
generates a header record, containing the name speci- 
fied in the operand, and a phase number of 001. For 
succeeding phase cards of the same multiphase pro- 
gram, the Linkage Loader generates a header record, 
containing the name specified by the first phase card, 
and a phase number determined by incrementing a 
counter each time a phase card with a blank operand 
is encountered. Therefore, the first phase card with a 
blank operand indicates the beginning of the pro- 
gram's second phase, and the header record for this 
phase contains the phase number 002. 

The programmer can specify the phase number, for 
any phases after the first phase, by putting a three- 
digit phase number (other than 999) in columns 6 
through 8 of a blank-operand phase card. This phase 
number must be higher than the last phase number 
assigned; otherwise the Linkage Loader will ignore 
the user-assigned number and will assign the next 
sequential number to the phase. Following a user- 
assigned phase number, the next blank-operand phase 
card without a user-assigned number will be assigned 
a phase number one higher than the user-assigned 
phase number. 

The following rules apply to the use of the phase 
card: 

1. A phase card immediately precedes each group 
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of Call cards (call, calln, callp) that specify the 
subprograms to be included in that phase. 

2. If the first phase card is omitted, the name of 
the first subprogram that is processed is used by the 
Linkage Loader as the name of the entire multiphase 
program. The header record of each phase will have 
this name. A single-phase program that consists of 
more than one subprogram should have a phase card 
if the program is relocated and executed in the same 
job. Because the subprograms are not necessarily 
processed in the order they are called, the phase card 
is needed to set the program name for the Monitor 
control card that executes the program. 

3. A phase card with a program name in the oper- 
and field causes the Linkage Loader to reset the relo- 
cation factor to Base Zero and to erase from the Link- 
age Loader's symbol table any linkage symbols left 
from processing previous subprograms. (This erasure 
of symbols can be controlled by use of the prtct 
card, which is described later.) 

4. A phase card with a blank operand field does 
not reset the relocation factor, nor does it cause the 
erasure of any symbols from the symbol table. 

5. Columns 60 through 70 of the phase card must 
be left blank. (These columns are used by the Link- 
age Loader. Their contents are defined in the System 
Generation publication. ) 

Example 

Because the phase card is most commonly used with 
the basei card, examples illustrating phase card use 
follow the basei card description. 

BASEI Card 

The basei card is used to control the relocation factor. 
This control of the relocation factor enables the pro- 
grammer to direct the Linkage Loader to relocate a 
phase in such a manner that it will overlay the pre- 
ceding phase at a predetermined point. 

Four types of operands can be used in a basei card: 
1. Linkage Symbol: If a linkage symbol appears in 
the operand of a basei card, the Linkage Loader sets 
the relocation factor to the address equated with that 
symbol in the Linkage Loader's symbol table. For this 
reason, the linkage symbol must be defined by a sub- 
program processed before the one that includes the 
basei card. In most cases, the linkage symbol is de- 
clared by the title card of a previous subprogram. 
Using a subprogram name as a basei operand en- 
ables one phase of a program to be relocated to the 
origin point of a subprogram in a previous phase even 
though, at the time the basei card was coded, the 
actual origin point of the previous subprogram had 



not yet been determined. When the phase that in- 
cluded the basei card is loaded into core storage, it 
will overlay the previous phase, beginning at the 
origin point of the subprogram named in the operand 
of the basei card. 

Note: Because Autocoder provides the defin state- 
ment defining linkage symbols other than the origin 
point of a subprogram, Autocoder users can construct 
phases that overlay preceding phases at locations 
other than the beginning of a subprogram. 

2. Actual Address: If the operand of a basei card 
contains an actual address, the Linkage Loader sets 
the relocation factor to that address. Care must be 
exercised in the use of this operand, because the final 
location of program elements that preceded a basei 
card containing an actual address cannot always be 
predicted. 

3. *-\-X00: If the operand of a basei card contains 
*+xoo (asterisk, plus sign, X, zero, zero), the Linkage 
Loader sets the current relocation factor to the next 
highest address that is a mutliple of 100. (If the re- 
location factor is already a multiple of 100, no adjust- 
ment is performed.) This operand is not necessarily 
related to a multiphase program. It is provided to 
control the relocation of subprograms that depend on 
certain areas being located at an even-hundred ad- 
dress. ( For example, use of the Autocoder Clear Stor- 
age instruction can result in this requirement.) 

4. Blanks: If the operand field of a basei card is 
blank, the Linkage Loader sets the relocation factor to 
Base Zero unless the preceding mode control card 
specified sg mode. In sg mode, a blank basei operand 
causes relocation at absolute zero. This form of reloca- 
tion should be used with extreme caution. 

Each time the Linkage Loader encounters a basei 
card, it performs the following functions: 

1. It sets the relocation factor to the address value 
specified by the operand of the basei card. 

2. It erases from the symbol table all linkage sym- 
bols equated to addresses higher than the address 
value specified by the operand of the basei card. 
(This erasure occurs only for basei cards with a sym- 
bol or actual address in the operand. The *+xoo oper- 
and does not cause symbols to be erased.) The era- 
sure of symbols can be controlled by the prtct card, 
which is described later. 

The following rules apply to the use of the basei 
card: 

1. A basei card, when placed in the Standard or 
Alternate Input Unit, should immediately follow a 
phase card. A basei card will affect all subprograms 
that have not been processed, even if the calls for 
those subprograms preceded the basei card. (A prtct 
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card can be inserted between the phase card and 
basei card.) 

2. If a basei card appears in a subprogram, it must 
appear immediately after the title card. This loca- 
tion is required for subprograms that are on the Sys- 
tem Library file and are to be relocated to the same 
point each time. 

3. The address value of a linkage symbol used as 
the operand of a basei card must have been defined 
during processing of a previous subprogram. 

Example 1 

This example illustrates the construction of a two- 
phase program from two subprograms, spi consti- 
tutes the first phase of the multiphase program, and 
sp2 constitutes the second phase, which is to overlay 
the first completely. Both subprograms are on the 
System Library file. Neither of the subprograms con- 
tains imbedded calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 



phase 
call 



phase 
basei 



SAM 
SPI 



SPI 



CALL SP2 

The Linkage Loader proceeds as follows: 

1. phase sam: A header record is created. It con- 
tains the name sam and the phase number 001. 

2. call spi: The name spi is placed on the re- 
quest list. 

3. phase (blank operand): All previous calls are 
processed. (In this example, spi is the only previous 
call.) A termination record is generated for the first 
phase. A header record is generated for the second 
phase; it contains the name sam and the phase num- 
ber 002. 

4. basei spi: The relocation factor, which is not 
affected by a blank-operand phase card, is set to the 
address value established by the title card of spi. 
(All linkage symbols with an address equal to or 
higher than the title card address are erased from 
the symbol table.) 

5. call SP2: The name SP2 is placed on the re- 
quest list. The Linkage Loader resumes reading from 
the Standard Input Unit and finds no more Linkage 
Loader control cards. SP2 is located and processed. 

The memory maps are as follows: 



Example 2 

This example illustrates the construction of a two- 
phase program from five subprograms, spi and SP2 
constitute the first phase and SP3, sp4, and sps consti- 
tute the second phase, which is to overlay only sp2 
of the first phase (leaving spi in storage). All the sub- 
programs are on the System Library file. None of 
them contain imbedded calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 



PHASE 


MATILDA 


CALL 


SPI 


CALLN 


SP2 



PHASE 

BASEI 



CALL 
CALL 



SP2 
SP3 
SP4 



CALL SP5 

The Linkage Loader proceeds as follows: 

1. phase matilda: A header record is created. It 
contains the name matilda and the phase number 
001. 

2. call spi: The name spi is placed on the request 
list. 

3. calln sp2: In accordance with the procedure for 
calln cards, spi, then SP2, is located and processed. 

4. phase (blank operand): A termination record 
is generated for the first phase. It contains the entry 
point specified by the Termination card of whichever 
subprogram was the primary one. A header record is 
generated for the second phase. It contains the name 
matilda and the phase number 002. 

5. basei SP2: The relocation factor is set to the ad- 
dress value established by the title card of sp2. (All 
linkage symbols with an address value equal to or 
higher than the title card address are erased from 
the symbol table.) 

6. call sp3: The name SP3 is placed on the request 
list. 

7. call SP4: The name SP4 is placed on the request 
list. 

8. call sps: The name sps is placed on the request 
list. The Linkage Loader resumes reading from the 
Standard Input Unit and finds no further Linkage 
Loader control cards. sp3, sp4, and sps are located on 
the Library and processed. 

The memory maps are as follows: 



Phase 



Phase 2 



SPI 



SP2 



Phase 



Phc 



SPI 


SP2 


__. 




t 






SPI 


SP3 


SP4 


SP5 
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Example 3 

This example illustrates the construction of two sep- 
arate multiphase programs during a single run of the 
Linkage Loader. All subprograms are on the System 
Library file, and none of them contain imbedded 
calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 

PHASE OLSEN 

CALL SP1 

PHASE 

BASE1 SP1 

CALL SP2 

PHASE JOHNSON 

CALL SP3 

PHASE 

BASE1 SP3 

CALL SP4 

The Linkage Loader proceeds as follows: 

1. phase olsen through call SP2: The Linkage 
Loader begins construction of a two-phase program 
in the manner illustrated by the preceding examples. 

2. phase johnson: The request list is checked for 
outstanding calls. The Linkage Loader finds the name 
sp2 on that list (from the call sp2 card), locates and 
processes SP2, and generates a termination record for 
the preceding phase. The relocation factor is then 
reset to Base Zero, and linkage symbols are erased 
from the symbol table. A header record is generated 
for the next phase. It contains the name johnson and 
the phase number 001. 

3. call SP3 through call SP4: The Linkage Loader 
constructs the second multiphase program. 

The memory maps are as follows: 



Phase 1 



Phase 2 



Phase 1 



Phase 2 



Program OLSEN 
SP1 



SP2 



Program JOHNSON 
SP3 



SP4 



Note: The two programs are not necessarily re- 
lated in any way. This example is designed to illus- 
trate a means of directing the Linkage Loader to 
produce a Job file that is, in effect, a library of pro- 
grams in absolute format. 



PRTCT Card 

The prtct card is used to limit the erasure of linkage 
symbols from the symbol table. The Linkage Loader 
will retain in its symbol table all linkage symbols 
with addresses equal to or higher than the address 
value specified by the operand of the prtct card. The 
operand of a prtct card can be either a linkage sym- 
bol or an absolute address. If System Generation 
(sg) mode has been specified, this protection will be 
retained until it is changed by another prtct card or 
by the initialization performed each time the Linkage 
Loader is brought into core storage for execution. If, 
however, System Generation mode has not been spe- 
cified, the next phase card with a symbolic name in 
the operand will reset the area of protection to /ams/; 
this has the effect of cancelling all protection. 

The following rules apply to the use of the prtct 
card: 

1. The prtct card must precede any control card 
that would cause erasure of symbols higher than the 
address value specified by the operand of the prtct 
card. 

2. The address value of a linkage symbol used as 
the operand of a prtct card must have been defined 
during the processing of a previous subprogram in 
the same execution of the Linkage Loader. 

Example 

This example illustrates construction of a two-phase 
program in which one subprogram must be placed in 
upper storage and be used by other subprograms in 
both phases. All of the subprograms are on the System 
Library file, and none of them contain imbedded 
calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 



PHASE 


OTHELLO 


CALL 


SP1 


CALLN 


SP2 


BASE1 


30000 


CALL 


SP3 


PHASE 




PRTCT 


30000 


BASE1 


SP2 


CALL 


SP4 



The Linkage Loader proceeds as follows: 

1. phase othello through CALLN SP2: spi and SP2 
are processed as explained in previous examples. 

2. basei 30000: The relocation factor is set to 30000. 
(Note that all previous calls have been satisfied be- 
cause of the calln card. Note also that if sp2 had 
contained an imbedded call for a subprogram that 
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had not yet been processed, the new relocation factor 
would be applied to that subprogram.) 

3. call SP3: The name SP3 is placed on the request 
list. 

4. phase ( blank operand ) : SP3 is located and proc- 
essed. A termination record is generated for the first 
phase. A header record is generated for the second 
phase. It contains the name othello and the phase 
number 002. 

5. ptrct 30000: The Linkage Loader notes that 
linkage symbols equated to an address value of 30000 
and higher are not to be erased from the symbol 
table. (The operand of the prtct card could also be 

SP3.) 

6. basei sp2: The relocation factor is reset to the 
address value established by the title card of sp2. 
Linkage symbols equated to an address value higher 
than sp2 and lower than 30000 are erased from the 
symbol table. 

7. call sp4: sp4 is placed on the request list. The 
Linkage Loader resumes reading from the Standard 
Input Unit and finds no more Linkage Loader control 
cards. SP4 is located and processed. 

The memory maps are as follows: 



Phase 1 



SP 


1 SP2 


| 30000 | 




1 — 


SP3 




' 


' 




' 


' 



| 30000 | 


SPl J SP4 J — 


SP3 



Phase 2 



BASE2 Card 

The operand of the bases card, which can be either a 
linkage symbol or an absolute address, sets the upper 
limit of a common data area. 

Each time the Linkage Loader encounters a bases 
card, it sets the downward relocation factor. This 
factor is then used for the adjustment of addresses 
that refer to a common data area. 

The following rules apply to use of the base2 card: 

1. The base2 card must be positioned in the Stand- 
ard Input Unit so that it is read before the processing 
of any subprograms affected by it. The base2 card 
can also be placed within a subprogram, but before 
any references to a common data area. 

2. More than one base2 card can be used, but rule 
1 also applies to the additional cards. 

3. If a linkage symbol is used for the operand of a 
base2 card, the address value of that symbol must 



have been defined during the processing of a previous 
subprogram. 

4. The base2 limit applies to all succeeding subpro- 
grams processed in the Linkage Loader run, unless 
changed by another base2 card or by a phase card 
with a name in the operand. A phase card with a 
name in the operand resets the downward relocation 
factor to the top of core storage minus two. 

Example 

This example illustrates the construction of a single- 
phase program from three subprograms, each of 
which refers to a common data area. All three sub- 
programs are on the System Library file, and none of 
them contain imbedded calls. 

The sequence of cards in the Standard Input Unit 
is as follows: 



BASE2 
CALL 



38000 
SPl 



CALL SP2 

CALL SP3 

The Linkage Loader proceeds as follows: 

1. base2 38000: The factor for downward relocation 
is set to 38000. 

2. call spi through call SP3: These three subpro- 
grams are located and processed. During processing, 
all references to the common data area are adjusted 
in accordance with the factor set by the base2 card. 

The memory map is as follows: 



38000 



SPl 



SP2 



SP3 



Common 

Data 

Area 



7 

Top of Core Storage 

SNAP Card 

The snap card directs the Linkage Loader to include 

the Snapshot program in a specified subprogram. 

( The Snapshot program is one of the Utility programs 

provided in the Operating System. See the Utility 

Programs publication for a description of the Snapshot 

program. ) 

The operands used in this card are as follows: 
suBPRGNAMExxxxxyyyyyzzzzzyyyyyzzzzzss 

where: 

subprgname is the one- to ten-character subprogram 
name, left-justified, with trailing blanks in a ten- 
position field. 

xxxxx is the address of the instruction immediately be- 
fore which a Snapshot is to be taken. 

yyyyy is the address of the lower limit of an area for 
which a Snapshot is to be taken. This address, if 
not an even hundred, will be changed to an even 
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hundred by the Snapshot program, which re- 
places the units and tens positions with zeros, 
zzzzz is the address of the upper limit of an area for 
which a Snapshot is to be taken. This address, if 
not an address ending in 99, will be changed by 
the Snapshot program, which replaces the units 
and tens positions with 99. 
ss is the length of the instruction at location xxxxx. If 
the instruction length is less than 10, it should be 
written as a two-digit number with a leading 
zero, e.g., 07. 
Note 1: ss must be in card columns 56 and 57. 
Therefore, if only one area is to be snapped, leave 
blanks for the second yyyyyzzzzz. 

Note 2: Do not put commas between operands. 
The addresses used as operands are the relocatable 
addresses for a program compiled from 00000 up- 
ward. Normally these addresses can be obtained from 
the listing of the compilation. The Linkage Loader 
will add the value equated to the subprogram name 
linkage symbol to the addresses specified in the oper- 
and field of the snap card. However, if the origin of 
the subprogram was not at 00000, the user must sub- 
tract the origin value, as specified in the Autocoder 
org card, from the compiled addresses to get the ad- 
dresses to be used on the snap card. If Fortran is 
used, the user must subtract 1 from the compiled 
addresses. 

Columns 6 through 10 of the snap card can be used 
to establish a one- to five-character identification for 
the Snapshot(s) specified by the card. Any characters 
in those columns will be printed on the Snapshot 
listing. 

The instruction at the point where the Snapshot is 
to be taken must be at least seven characters long, 
cannot be chained, cannot be part of an iocs macro- 
instruction, and cannot contain any linkage symbols. 

The following rules apply to the use of the snap 
card: 

1. A snap card must be positioned in the Standard 
Input Unit after the subprogram that it affects, or the 
call for that subprogram, but before the subprogram's 
name is erased from the Linkage Loader symbol table 
and before the end of the phase. 

2. Any number of snap cards can be submitted be- 
tween phase cards. 

3. A snap card can contain either one or two sets of 
upper and lower limits for Snapshot areas. 

4. A snap card forces all pending calls for sub- 
programs. 

5. The Snapshot program must be in the Resident 
Monitor or in the library designated as the System 
Library file for this Linkage Loader run. 



The snap card can be used only with a program 
that has been compiled. For a compile-and-go opera- 
tion requiring Snapshot listings, use a Snapshot call- 
ing sequence in the source program. This sequence is 
given in the Utility Programs publication. 

The Linkage Loader will replace the instruction be- 
fore which the Snapshot is to be taken with a branch 
to a sequence that links to the Snapshot routine. The 
replaced instruction will appear in the linkage se- 
quence, which is placed after the named subprogram. 

INPUT Card 

The input card can be used to direct the Linkage 
Loader to read its control cards and relocatable object 
decks from a source other than the Standard Input 
Unit. The operand of the input card is the name of 
the symbolic unit to be substituted for the Standard 
Input Unit. However, if System Generation (so) 
mode has been specified, the input card can only 
contain the operand MW2 or sru. 

The following rules apply to use of the input card: 

1. The name of the substituted symbolic unit must 
be one that is currently assigned to a physical unit. 
(See the section "Assignment of Input/Output 
Units.") 

2. End of file at the substitute unit causes the Link- 
age Loader to resume reading from the Standard In- 
put Unit. 

3. input cards can be placed at any point in the 
control card deck for the Linkage Loader. 

4. The input card can contain the operand siu. In 
this case, the Linkage Loader resumes reading from 
the Standard Input Unit. Such a card would be used 
in a substitute unit, after an input card in the Stand- 
ard Input Unit had directed the Linkage Loader to 
begin reading from that substitute unit. 

Note: The term Standard Input Unit, as used in 
the above description, refers to the unit currently 
used by the Monitor as its source of control informa- 
tion. This source could be either the Standard or 
Alternate Input Unit. 

TITLE Card 

The title card is the first card of each subprogram. 
It defines the name of the subprogram as a linkage 
symbol. It is compiled by the Autocoder, Fortran, 
and cohol language processors. The format for the 
title card is: 

title subprgnamexxxxx yyyyy 

where: 

subprgname is the one- to ten-character subprogram 
name. (If fewer than ten characters, it is left- 
justified with trailing blanks in a ten-position 
field.) 
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xxxxx is the base to which the subprogram was com- 
piled. This is normally 00000 or blank for Auto- 
coder. (If blank, 00000 is assumed by the Link- 
age Loader.) It is 00001 for Fortran programs; 
and it is the size of ibcobol for cobol programs. 
yyyyy is the total number of core-storage locations in 
the common data area required by Autocoder 
subprograms. This field is blank for Fortran and 
cobol subprograms. 
Note: Five blanks separate xxxxx and yyyyy. 
The value expressed by xxxxx, which is the low 
origin point for the subprogram, is subtracted from 
the current upward relocation value to produce the 
relocation factor for this subprogram. 

The value expressed by yyyyy, the common data 
area size for Autocoder programs, is added to each 
relocated load address to determine if core storage 
has been exceeded. If core storage is exceeded while 
in the System Generation (sg) mode of operation, 
the Linkage Loader prints the message core exceeded 
on the Standard Print Unit. This is only a warning 
message; the Linkage Loader puts the subprogram 
that exceeded core storage on the Job file and, if 
requested by an exeq card, the subprogram is exe- 
cuted. However, if core storage is exceeded while not 
in the System Generation mode of operation, the ran 
is terminated. 

Note: The title cards generated by the cobol and 
Fortran processors do not contain the size of the 
common data area. Therefore, the core exceeded 
message will be produced only when the relocated 
load address exceeds the upper core-storage limit of 
the object machine. 

After the Linkage Loader reads a title card, it 
reads the next card in order to determine if it is a 
basei card. If so, the basei card will be processed be- 
fore the title card. 

The title cards generated by the language process- 
ors contain additional operands which are not used 
by the Linkage Loader; for instance, card columns 
6-10 contain the date, and card columns 73-80 con- 
tain the card sequence number and the subprogram 
identification, in that order. 

DISGO Card 

The disgo card specifies that the Go file is not to be 
searched for called subprograms. This card should be 
used to save search time when all called subprograms 
are on the System Library file. 

After the Linkage Loader reads the disgo card, it 
will not search the Go file (1) for the rest of the cur- 
rent Linkage Loader run, or (2) until a Congo card 
is read. 



The disgo card is needed because the calln, callp, 
phase, snap, and Monitor control cards, and the end 
of file on the Standard or Alternate Input Unit, cause 
the Linkage Loader to process all calls on its request 
list. For this processing, the Linkage Loader rewinds 
the Go file and searches it from the beginning. 

When a disgo card is in effect, the Go file must 
remain mounted, ready, and assigned by an asgn card. 
(For details about the asgn card, see the "Assign- 
ment of Input/Output Units" section.) 

CONGO Card 

The congo card cancels the effect of the disgo card. 
Thus, in the next search after the congo card, the Go 
file will be searched. 

The congo card is required only if a disgo card has 
been used because, if a disgo card is not used, the Go 
file is searched once in each search. 

Use of the CHAIN Feature 

The chain feature is a process by which multiphase 
programs can be created from modules that have 
been written in one or more of the Operating System 
languages. The programs are divided into portions, 
called .links, when they are processed by the Linkage 
Loader. These links are similar to phases that are 
created by the use of phase cards. However, phase 
cards can be used easily only with programs written 
in Autocoder. 

Because there is already a method within the Op- 
erating System of segmenting Autocoder programs by 
using phase cards, the chain feature is of most ad- 
vantage to the Fortran and cobol programmer. 
Chaining provides a convenient way of dividing a 
program that exceeds the available core storage into 
portions that are successively executed. For example, 
if a 41,000-character Fortran program is to run on a 
computer that has 40,000 positions of available core 
storage, a low-activity portion of the program can be 
segmented as a separate link. 

Chaining can also be used to combine subprograms 
that are written in different languages into one pro- 
gram. The chain feature enables the programmer to 
link into one job several programs that must operate 
on the same data and that otherwise would have to 
be executed in several consecutive jobs. Moreover, 
chaining permits different programmers to write seg- 
ments of a job. Because of the modularity of the 
finished job, changes to a portion of the job are more 
easily effected than if the job were all one program. 

Refer to the publication System Generation, Form 
C28-0352, under the topic "Creation Charts" for the 
specific Linkage Loader needed for chained programs. 
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General Considerations for Chained Programs 

The first link of the program is called the main link. 
Normally, the main link controls execution of all other 
links, which are called dependent links. 

The following rules apply to the main link: 

1. It can be written in Autocoder or cobol with 
the dependent links written in any language. It can 
be written in Fortran only if dependent links are 
written in Fortran or Autocoder. 

2. It can do any processing desired within the 
limits of the specified language. 

3. It must contain the definition of the entire Auto- 
coder or Fortran common data area used during 
execution of the main link and all dependent links. 

4. It should contain any secondary subprograms 
that are used by all dependent links (see "COMN 
Card"). 

5. It can make reference to linkage symbols de- 
fined only within itself. 

6. It, or one of the dependent links, must give 
control to the Resident Monitor at the /eop/ or /uep/ 
entry points when processing is completed (see "Use 
of Resident Monitor Functions"). 

A dependent link is any link of the program except 
the first one. A previous dependent link is any link 
defined before another dependent link. A subsequent 
dependent link is any link defined after another de- 
pendent link. The order of definition is the order in 
which the link control cards appear in the Standard 
Input Unit; it is not necessarily the order in which 
the links are executed. The following rules must be 
used when writing dependent links: 

1. A dependent link may have reference to any link- 
age symbol defined in the main link or within itself. 

2. A dependent link may have reference to any 
linkage symbol defined in a previous dependent link 
only if that portion of the dependent link containing 
the linkage symbol has not been overlaid. To prevent 
the symbol table of a dependent link from being over- 
laid, a prtct card must be used. 

3. A dependent link cannot have a reference to a 
linkage symbol defined in a subsequent link. 

4. A dependent link can do any processing desired 
within the limits of the specified language. 

5. A dependent link can, but usually does not, 
overlay any part of the main link ( see "LINK Card" ) . 

Because the programmer may specify the point to 
which a dependent link is to be relocated (see "LINK 
Card"), he must make certain that none of the sub- 
programs required in future processing are overlaid. 
The programmer must also ensure that the links con- 
taining linkage symbols with a reference from a de- 
pendent link are in core storage at the time needed. 

The Linkage Loader assigns a number to each link. 



The number assigned to the main link is 001; the first 
dependent link is 002, the next 003, etc. 

Each link is composed of one or more subprograms. 
When it is constructing the chained program, the 
Linkage Loader can obtain the subprograms from the 
Go file, the System Library file, or the Standard In- 
put Unit. 

Special Considerations for COBOL Programs 

The Procedure Division of all cobol programs uses a 
small section of upper core storage. In this discussion 
of the chain feature, this section of core storage is 
called the cobol common area. When the Linkage 
Loader is loading a main link written in cobol, there 
should be a base2 card with /ams/ as the operand. 
This forces cobol common to reside as high as pos- 
sible in core storage. If there is a Fortran dependent 
link of a program whose main link is written in cobol, 
base2 must be set at /ams/ minus the number of char- 
acters in the cobol common area to avoid overlaying 
that part of core storage. 

The bases card is written, in this case, as: 
base2 user-supplied-actual-address 
User-supplied-actual-address is /ams/ less the num- 
ber of core positions used by the cobol common area, 
where /ams/ is the size of core storage minus 2. The 
size of the cobol common area can be determined by 
referring to the listing which appeared as output on 
the spr as a result of the compilation of the program. 
The number of characters used is specified at the end 
of the main program before the memory map. 

For a cobol program, the first operand (hereafter 
called the linksymbol) of any link card contains the 
first seven characters of the program-id source state- 
ment. The remaining three characters of the link- 
symbol field contain the serial number of the sub- 
program. The serial number is that number given at 
compilation time to the four modules of a cobol pro- 
gram. Each module has an embedded call for the 
next higher module. 

If the main link of a multiphase program is written 
in cobol, its link card is written: 

LINK MAINPGM001 

This calls the first module of the cobol main program 
which, in turn, calls the next module, etc. Dependent 
links written in cobol are called using 002 as the last 
three characters of the linksymbol. This is done so 
that the Data Division ( module 001 ) of the main link 
is not overlaid by the dependent link. The link card 
of a dependent link written in cobol is written: 

LINK DEPENDL002 

In order to link together three cobol programs, it 
is necessary to avoid overlaying the Data Division of 
the main link. For example, if the three cobol links 
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(one main and two dependent) are named updatea, 
updateb, and updatec, respectively, the link cards 
necessary to chain these programs are: 

LINK UPDATEA001 
LINK UPDATEB002 
LINK UPDATEC002 

A chained program consisting of a cobol main link, 
two cobol dependent links, an Autocoder dependent 
link, and a fobtran dependent link requires the fol- 
lowing link cards : 

LINK UPDATEA001 
LINK UPDATEB002 
LINK UPDATEC002 
LINK AUTO 
LINK FORTRAN 

More than one multi-phase program may be built 
during an execution of the Linkage Loader. Each se- 
quence of multi-phase control cards begins with a 
link card and must be terminated by an end card. 
If the sixth operand of the exeq linkload card speci- 
fies cobol, all the main links in each multi-phase pro- 
gram must be cobol programs. 

The chain feature may be used also for single- 
phase programs to simplify input to the Linkage 
Loader. The control cards used with this option are: 

MON$$ EXEQ LINKLOAD„„X,COBOL 

ONEPHASE LINK ABCOBOL001 

END 

The above cards have the same effect as the follow- 
ing: 

MON$$ EXEQ LINKLOAD 

PHASE ONEPHASE 
DISGO 

CALL IBCBLADOVR 

CALL IBCBLDSPLY 

CALL IBCBLCMPAR 

CALL IBCBLSUBSC 

CALLN IBCOBOL 
CONGO 

CALL ABCOBOL001 
PHASE 

Control Cards for Chaining 

Five control cards describe the use of the chain 
feature in the Operating System. Two of these cards 
are optional; they are the comn card and the entry 
card. Three of these cards are required; they are the 
exeq linkload card, the link card, and the end card. 
Control cards for chained programs are summarized 
in Figure 4. 

EXEQ LINKLOAD Card 

The fifth and sixth parameters of the mon$$ exeq link- 
load card (used to execute the Linkage Loader) 



specify that the program is to be chained, define the 
name of the program, and indicate whether or not 
any of the subprograms were written in cobol (see 
"Use of Transitional Monitor" for details on the exeq 
linkload card ) . 

The fifth parameter must be specified; however, 
it may be a dummy name if the true name of the 
multi-phase program will appear on the main link 
card. 

LINK Card 

The link card defines a main or dependent link by 
specifying the main subprogram of the link. The link 
card for the main link may also indicate the multi- 
phase program name, if desired. The format of this 
link card is: 



link 



LINKSYMBOL 



or 



PHASENAME LINK LINKSYMBOL 

The link card for a dependent link may indicate, 
if desired, the point (base) to which the link is to be 
relocated. The format of this link card is: 

LINK LINKSYMBOL 

or 

LINK LINKSYMBOL, BASE 

linksymbol is the linkage symbol for the name of 
the main subprogram of the link. For a cobol pro- 
gram, linksymbol is the first seven characters of the 
eight-character ident field of the program-id source 
statement. (For a more detailed discussion of link 
cards for cobol links, see "Special Considerations for 
COBOL Programs.") 

base is the linkage symbol or absolute address of 
the origin point. If base is omitted for a dependent 
link, Linkage Loader assigns the origin of the depend- 
ent link at the end of the main link. The base operand 
must not be used for dependent links in a program 
written in cobol. 

The main subprogram for a link would normally be 
on the Go file or the System Library file. If the sub- 
program is in the form of a relocatable deck, however, 
the deck must be placed on the Standard Input Unit 
following its link card. 

COMN Card 

The comn card specifies additional subprograms to be 
included with the link. This card calls additional sub- 
programs from the Go file or System Library file. 
These subprograms are loaded before the subprogram 
named in the link card. 

The comn card must follow the link card defining 
the link. 

The formats of the comn card are: 

COMN SUBPGNAME1,SUBPGNAME2,SUBPGNAME3, 
. . . , SUBPGNAMEX 
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Location in 
Control Card 
Deck 


Format 


Functions 


Remarks 


6 15 


16 Card 20 
Type 


21 Operand(s) 


At the beginning of each 
main and dependent link; 
first LINK card follows 
EXEQ LINKLOADcard 


PHASE NAME 


LINK 

LINK 
LINK 


LINKSYMBOL 

LINKSYMBOL = Linkage symbol for name of 

main subprogram in link. 

LINKSYMBOL 

LINKSYMBOL, BASE 

BASE = Linkage symbol or absolute address 

assigned origin of dependent link. 


Specifies a main or dependent link. 

Card for main link may indicate program 
name . 

If BASE is omitted for a dependent link, a 
Linkage Loader sets the origin of the de- 
pendent link at the end of the main link. 

Main link ignores BASE parameter. 


For a COBOL program, LINKSYMBOL is 

the following: 

COBOL dependent link: the 7-character 

IDENT fieldof the PROGRAM-ID record. 

Autocoder dependent link: the 10-character 

operand of the TITLE statement. 

FORTRAN dependent link: the 10-character 

operand of the MON$$ EXEQ card. In Autocoder 

and FORTRAN languages, the LINKSYMBOL 

for COBOL programs must end in 002. 


Following the LINK card 




COMN 
COMN 


SUBPGNAME1, 

SUBPGNAME2,... 

SUBPGNAMEX 

SUBPGNAME1,, 

SUBPGNAME2,... 

SUBPGNAMEX 

SUBPGNAMEX= Name of subprogram 
to be included in link. 


Specifies subprograms (in addition to 
subprogram named in LINK card) to be 
included in the link. 


Two consecutive commas specify that all sub- 
programs before the two commas are to be 
loaded before any other subprograms named 
in the card. 

All subprograms named in COMN card are 
loaded before subprogram named in LINK card. 

COMN card can be used only for main link 
of program written in COBOL . 


After subprogram con- 
taining entry point 
specified in ENTRY card 




ENTRY 


LINKSYMBOL or xxxxx 

LI NKSYMBOL = Linkage symbol 

entry point. 

xxxxx = Absolute address. 


Specifies the entry point in a link that 
does not contain a primary subprogram. 


ENTRY card cannot be used for links written 
in COBOL. 


At the end of the chained 
program 




END 




Marks the end of the cards defining 
the chained program. 


This card must be present. 


NOTE: If a comment is punched in the LINK, COMN, or ENTRY cards, one blank must be left between the last operand and the comment. 



• Figure 4. Linkage Loader Control Cards for Chained Programs. 

COMN SUBPGNAME2„SUBPGNAME1,SUBPGNAME3, 
. . . , SUBPGNAMEX 

In the first example, all the subprograms named in 
the comn card are loaded before the main subprogram 
specified in the link card. The order in which the sub- 
programs named in the comn card are loaded depends 
on the order in which the Linkage Loader finds them. 
The finding order is the same as for the call card. 

In the second example, the subprogram subpg- 
name2 is loaded first. All other subprograms named in 
the comn card are loaded next, in the order in which 
the Linkage Loader finds them. Then, the main sub- 
program named in the link card is loaded. 

The two consecutive commas, shown in the second 
example, specify that all subprograms named before 
the two commas are to be loaded (in the order in 
which the Linkage Loader finds them) before any 
other subprograms specified in the card. 

Any relocatable decks between the link card and 
the comn card in the Standard Input Unit are loaded 
before the subprograms named in the comn card; 
any relocatable decks between the comn card and 
the next link card or the end card (see "ENTRY 
Card") are loaded after the subprograms in the comn 
card. 

Note: The comn card may be used in either main 
or dependent links of either Autocoder or Fortran 
programs; however, it may be used only in the main 
link of a program written in cobol. 

ENTRY Card 

The entry card is used to specify the entry point of 
a link that does not contain a primary subprogram. 



The entry point is specified by the operand of the 
entry card; this operand can be a linkage symbol or 
an absolute address. If the operand is a linkage sym- 
bol, it can be a subprogram name, or it can designate 
any point within a subprogram. An absolute address 
should be used only with extreme caution. The entry 
card must have a 4 punched in card column 72 unless 
the fifth parameter is used in the exeq linkload card. 

The entry card should be placed after the link card 
that specifies the entry point in the subprogram. 

Note: The entry card cannot be used for links 
written in cobol. 

END Card 

The end card marks the end of the chained program. 
This card is required. 

Execution of Chained Programs 

The main link normally controls the execution of a 
chained program and calls each dependent link at the 
appropriate point. Each dependent link normally re- 
turns control to the main link (see "Returning to the 
Main Link") or to the Resident Monitor at the /eop/ 
or /uep/ entry points. If a dependent link calls an- 
other dependent link instead of returning to the main 
link, the calling dependent link becomes, in effect, a 
new main link. 

The Chain subroutine is used to control the calling 
and loading of dependent links . by the Absolute 
Loader. The Return subroutine is used to return con- 
trol to the calling link. 
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Calling a Dependent Link 

In an Autocoder program, the calling sequence is 
the following: 

DCWS CHAIN 
DCW LINKNUM 
NOP 

linknum is defined in the calling link by: 

linknum dcw -j-nnn 
where: 

nnn is the three-digit number assigned to the depend- 
ent link by the Linkage Loader. 
In a FORTRAN program, the calling method is: 

CALL CHAIN (LINKNO) 

linkno is an integer ( variable or constant ) and desig- 
nates the number assigned to the dependent link 
being called. 
In a COBOL program, the calling method is as 
follows: 

(data-name-T 

CALL CHAIN USING j^^.J 

The literal designates the number assigned to the de- 
pendent link being called. 

Note: For more detailed explanations of the use of 
the chain feature with individual languages, see the 
discussions in the ibm 1410/7010 Operating System 
publications: Autocoder, Form C28-0326; COBOL, 
Form C28-0327; and FORTRAN, Form C28-0328. 

Returning to the Main Link 

In an Autocoder program, a dependent link can 
return control to the main link, call another depend- 
ent link, or return control to the Resident Monitor at 
the /eop/ or /uep/ entry point. Control can also be 
returned to the main link from dependent links writ- 
ten in Autocoder by using an Autocoder branch in- 
struction. To return to the next sequential instruction 
following the dependent link calling sequence, the 
user may give the following instructions: 

DCWS RETURN 
NOP 

In a FORTRAN program, returns are made by: 

CALL RETURN 

or 

RETURN 

The call return statement must be distinguished 
from the return statement. The call return state- 
ment is used only in links (main or dependent) that 
are Fortran main programs. The return statement is 
used only in links that are Fortran subroutines. 

In a dependent link, the call return statement 
causes a return to the main link at the statement im- 
mediately following the call chain statement that 
called the dependent link. 

In a main link, the call return statement causes 
either (1) a return to the Monitor (if no dependent 



links have been called) or (2) a return to the state- 
ment in the main link immediately following the last 
call chain statement executed (if any dependent 
links have been called ) . 

If another dependent link is called by a dependent 
link, control cannot be returned to the old main link 
written in Fortran. 

For an example of a Fortran program using the 
chain feature, see FORTRAN, Form C28-0328. 

In a COBOL program, a dependent link written in 
cobol may call another dependent link or return con- 
trol to the Resident Monitor at the /eop/ or /uep/ 
entry point. Ordinarily, control cannot be returned 
to the main link in cobol programs. The reason for 
this is that a dependent link written in cobol overlays 
the Procedure Division of the main link. Segments of 
the Procedure Division may be loaded many times 
without disturbing the Data Division. This enables 
files to be opened in an initialization phase, processed 
in a series of main phases, and closed in a termination 
phase. 

It is possible, however, to run a cobol multiphase 
program so that the main cobol link ( containing both 
Data and Procedure Divisions) remains in core stor- 
age and calls several cobol dependent Procedure Di- 
visions to use the Data Division of the main link. In 
order to do this, three things must be done in the 
second, dependent program. 

1. The Data Division of the main link must be du- 
plicated. 

2. There must be a dummy entry the size of the 
main link's Procedure Division. 

3. There must be a dummy entry the size of the 
main link's cobol common area. 

As stated above, the dependent link written in 
cobol overlays the Procedure Division of the main 
link. The procedure outlined below is designed to 
avoid overlaying that section of core storage. The 
main link is executed with a phase card (containing 
no operand) placed at the end of the Linkage Loader 
control cards. The phase card gives the ending ad- 
dress of the main link. This address must be used as 
the basei value when the dependent link is compiled. 
The basei value minus the address of the first literal 
defined in the second module of the cobol main link 
gives a value which is the size of the dummy entry 
needed to avoid overlaying the main link's Procedure 
Division. 

A dummy entry the size of the main link's cobol 
common area is needed to protect that part of core 
storage. This entry forces the dependent link's Pro- 
cedure Division common area to load below the main 
link's cobol common area in core storage. For an 
example of a cobol program thus chained together, 
see COBOL, Form C28-0327. 
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Use of Resident Monitor Functions 



Resident Monitor functions can be used through link- 
age sequences and system symbol references coded 
into a source program. 

The linkage sequences are branch instructions and, 
usually, one or more fields of control information. The 
branch instruction gives control to a routine in the 
Resident Monitor. The linkage sequences are listed in 
Figure 5. 

Macro-instructions to generate most of the link- 
age sequences are included in the Autocoder Macro 
Library. These macro-instructions are discussed in the 
section following Figure 5. 

The system symbols refer to areas of the Communi- 
cation Region, so that all dependent programs can use 
certain information stored in the Resident Monitor. 
System symbols referring to areas in the Communica- 
tion Region are listed in Figure 6. 



Use of Communication Region 

Contents of the Communication Region 

Information in the Communication Region can be used 
by any dependent program at any time. However, the 
information can be modified only through the linkage 
sequence described below. 

Some Communication Region fields contain data; 
others contain an address constant that gives the loca- 
tion of an area or data. 

Each area of the Communication Region contains a 
word mark in its high-order position only. 

Modification of the Communication Region 

To modify a field of the Communication Region, the 
dependent program must contain a linkage sequence 
constructed as follows : 

/mcr/ 

/xxx/ 

(low-order address of information to be 

placed in Communication Region field 

/xxx/ ) 

(address of dependent program routine 

to be given control if field cannot be 

modified ) 
(Next sequential instruction in dependent pro- 
gram) 



BXPA 
DCW 
DCW 



DCW 



An example of the need for a dependent program to 
modify a Communication Region field is modification 
of the /ipi/ field during one program to set a switch 
for a later program in the same job. The following 
Autocoder macro-instruction can be used to generate 
the linkage sequence for modification of a Communi- 
cation Region field: 

anylabel monop MODiFY,xxx,yyyyy,zzzzz 
where: 

anylabel is any symbolic label. 
monop must appear as shown. 
modify must appear as shown. 

xxx is the system symbol, without slashes, of the Com- 
munication Region field to be modified. 
yyyyy is the low-order address of the information to 

be placed in the Communication Region field, 
zzzzz (optional) is the address to which control is to 
be given if the Communication Region field can- 
not be modified. If this operand is omitted, con- 
trol will be returned to the next sequential 
instruction after the macro-instruction. 



Use of Unit-Record Routines 

The three unit-record routines in the Resident Monitor 
can be used by dependent programs. One of these 
routines reads from the Standard or Alternate Input 
Unit, another writes on the Standard Print Unit, and 
the third writes on the Standard Punch Unit. 

All three routines perform their functions with un- 
blocked records, in Move mode. If tape is used for 
any of the routines, the unit-record functions are per- 
formed in odd parity, and the records are unblocked. 

Read Routine 

The Read routine reads 80-character records from the 
Standard or Alternate Input Unit. ( In constructing the 
linkage sequence to the Read routine, the programmer 
makes no distinction between reading from the Stand- 
ard or Alternate Input Unit. ) 

The high-order address of the input area last filled 
by the Read routine is placed in the /crd/ field in the 
Communication Region, /crd/ must be used to retrieve 
information from an input area. The input areas are 
in the Resident Monitor. Word marks must not be set 
or cleared in the input areas. 
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Linkage Sequence in 




Resident Monitor Functions 


Autocoder Language 


Remarks 


Read Routine: Reads 80-character 


B /RSI/ 


/MCS/ contains the Channel Status Character constructed by the 


records from Standard Input Unit and 


B (address of end-of-file routine 


Resident IOCS from any machine indicators turned on by read 


Alternate Input Unit 


in dependent program) 


errors. 




BBE USERERROR,/MCS/,n 


The Channel Status Character is described in the Basic Input/ 




NSI 


Output Control System publication. 




Where the contents of n must be selected 






by the user. 




Print Routine: Writes 132-character 


One output area: 


Output areas defined by dependent program, 134 positions long 


records on Standard Print Unit 


BXPA /PRT/ 


1. First position. Carriage-control character. (See Figure 7.) 




DCW #5 


2. Positions 2 through 133. Record to be written on 




DCW (high-order address of 


Standard Print Unit. (If tape, first character is also written.) 




output area) 


3. Position 134. Group mark with word mark. 




NSI 






Two output areas: 






BXPA /PRT/ 






DCW #5 






DCW (high-order address of 






output area) 






DC (high-order address of other 






output area) 






NSI 




Punch Routine: Punches 80-character 


One output area: 


Output areas defined by dependent program, 81 positions long: 


records on Standard Punch Unit 


BXPA /PCH/ 


1 . Positions 1 through 80. Record to be punched by 




DCW #5 


Standard Punch Unit. 




DCW (high-order address of 


2. Position 81 . Group mark with word mark. 




output area) 






NSI 






Two output areas: 






BXPA /PCH/ 






DCW #5 






DCW (high-order address of one 






output area) 






DC (high-order address of 






other output area) 






NSI 




Console Inquiry Routine: Clears /MCI/ 


BXPA /MCR/ 


High-order position of input message area is designated by /RIQ/ 


to blank, informs operator of need for 


DCW /MCI/ 


Operator identifies input message with$3x. x is placed in /MCI/. 


information, enters waiting loop until 


DCW (address of a blank) 


MESSAGE is the label for the console printer message, coded 


operator has typed input, and returns 


DCW (address of dependent pro- 


in the dependent program, that informs the operator of the need 


control to NSI . 


gram's error routine) 
IOCTL TYPE,MESSAGE 
BCE * -11, /MCI/ 
NSI 


for the $3x message . 


Wait-Loop Routine 


B /WAT/ 


Console inquiry message, $50, causes the Resident Monitor to 




NSI 


exit from the Wait-Loop routine and return control to NSI. 

NOTE: If the HALT option was specified in the Wait Loop routine, 
press INQUIRY REQUEST, press START, and enter console inquiry 
message $50. 


Load Routine: Locates and loads a 


Locate, load, and execute phase: 




phase on the Job file or System 


B AOD/ 




Operating File (as specified on the 


DCW +nnn 




EXEQ card for the program) . 


Locate and load phase: 
B AOD/ 
DCW -nnn 
NSI 

nnn = phase number of a phase of the 
program being executed 




Subroutines of Load Routine: 






1 . Backspace System Tape: Backspaces 


ZA (number of records to be back- 




records on the Job file or System 


spaced, minus one),X13 




Operating File (as specified on the 


B /ZBS/ 




EXEQ card for the program) . 


NSI 




2. Read System Tape: Reads one rec- 


BXPA /ZRR/ 


The fourth instruction is optional. It will give control to a 


ord from the Job file or System 


DCW (@L@ for Load mode or @M@ 


dependent program error routine (USERERROR). /ZRS/ contains 


Operating File (as specified on the 


for Move mode) 


the Channel Status Character constructed by the Resident 


EXEQ card for the program) . 


DCW (input area address) 
BBE USERERROR./ZRS/,n 
NSI 


IOCS from any machine indicators turned on by read errors. 
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Linkage Sequence in 




Resident Monitor Functions 


Autocoder Language 


Remarks 


Subroutines of Load Routine (Continued): 


Where the contents of n must be selected 
by the user. 




3. Rewind System Tape: Closes and 


B /ZRW/ 




opens, with rewind and label 


NSI 




checking if applicable, the 






Job file or System Operating 






File (asspecifiedon the EXEQ 






card for the program) . 






4. Simple Search of System Tape: 


B /ZSS/ 




Locates the requested phase 


DCW (three-position unsigned phase 




of the program currently being 


number) 




executed. 


DCW (address of dependent program 
routine to be given control if 
phase is not found) . 

NSI 




5. Read System Disk: Reads one 


Read Specific Track: 


Input area defined by Resident Monitor: High-order position 


record in load mode from the 


BPXA /ZRR/ 


is/MBF/. Low-order data position (one position left of 


Job file or System Operating 


DCW @N@ 


terminating group mark with word mark) is/MBX/. 


File (asspecifiedon the 


BBE USERERROR,/ZRS/,n 




EXEQ card for the program) 


NSI 




into an input area. 




USERERROR is the label of an error routine in the dependent 




Read Next Track: 


program. /ZRS/ contains the Channel Status Character 




BXPA /ZRR/ 


constructed by the Resident IOCS from any machine indicators 




DCW (four-character track address) 


turned on by read errors. 




BBE USERERROR,/ZRS/,n 






NSI 






Where the contents of n must be selected 






by the user. 




End-of-Program Routine 


Normal End of Program: 
B /EOP/ 

Unusual End of Program: 
B /UEP/ 

Special End of Program: 

BXPA /MCR/ 

DCW /CGO/ 

DCW (address of an A bit) 

DCW (address of dependent program 
routine to be given control 
if field cannot be modified) 

NSI 

NOTE: NSI'is usually 
B /EOP/. 




Modification of Communication 


BXPA /MCR/ 




Region Routine 


DCW /XXX/ 

DCW (low-order address of informa- 
tion to be placed in field 
/XXX/) 

DCW (address of dependent program 
routine to be given control 






if field cannot be modified) 





NSI is the next sequential instruction in the dependent program. 

Figure 5. Linkage Sequences for Use of Resident Monitor Functions (Continued) 
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System 




Contents 




Modi- 


System 




Contents 




Modi- 




Symbol 


Contents of Field 


Type 


Length 


fiable 


Symbol 


Contents of Field 


Type 


Length 


fiable 




/AMS/ 


Actual machine size minus two (highest lo- 
cation that can be loaded by the Load 
routine). For example, for a machine with 
80,000 positions of core storage, this field 


Address 
Constant 


5 


No 


/PHN/ 


Phase number of program phase currently be- 
ing executed. (This area is set to 001 at 
each Monitor EXEQ card.) 


Data 


3 


No 


















would contain 79997. This field is filled 








/PNM/ 


Name of program currently being executed. 


Data 


10 


Yes 






in at System Generation. 










(The name is left-justified in the area.) 










/CRD/ 


Contains the high-order address of the 
input area last filled by the Resident 
Monitor's Read routine. 


Address 
Constant 


5 


No 


/SIZ/ 


Highest location loaded for the current 
dependent program (including any previous 
phases of it). This field is set by the 
Resident Monitor's Load routine. 


Address 
Constant 


5 


Yes 
























/DAT/ 


Date (first two positions for the year, fol- 


Data 


5 


No 




























lowed by three positions for the day). This 








/TPB/ 


Lowest location of the area reserved for 


Address 


5 


No 






area is set by a Monitor control card dur- 










programs under control of the Tele- 


Constant 










ing initialization of the Resident Monitor. 










processing Supervisor. (Tele-processing 












(See the section, "Use of Transitional 










Systems are described in the Tele- 












Monitor.") 










processing Supervisor publication.) This 
location is also the top of the Resident 










/I PI/ 


Interprogram information. (This area can 


Data 


5 


Yes 






be used to store control information be- 
tween runs within a job. For example, a 










Monitor minus the initialization routine. 










/MCI/ 


Set by console inquiry $3x, where x is 


Data 


1 


Yes 






program can set switches in this area that 










placed in /MCI/. It is set to blank by 












can be tested by the next program exe- 
cuted.) This area is set to zeros between 










End-of-Program routine. 
































each job, but certain systems programs 








/MGA/ 


Contains track address of last track on 


Disk 


4 


Yes 






(e.g., Sort Definition, Linkage Loader) 
alter its contents. 










disk Go file. 


Address 








/CGO/ 


Go and other indicators. The A bit ON 
indicates that the contents of the Go 


Data 


1 


Yes 




/LIN/ 


Number of lines per page for printer out- 


Data 


2 


Yes 






put. This field is set at System Genera- 










and Job files are not valid. The B bit 












tion. (This field can be reset by any 










ON indicates that a language processor 












program that wishes to establish a con- 










should put its output on the Go file. The 












stant that can be compared to a program 










B bit OFF indicates that the Go file 












counter for its printer output. However, 










contents are not valid. 












any program that resets this field must 










These indicators are set by the language 












set it back to the original value before 










processors, Linkage Loader, Monitor 












end of program .) 










MODE control card, and dependent 






















programs. Both bits are turned OFF be- 










/ORG/ 


Contains lowest location of storage area 
available to dependent programs. (This 
field, which is set at System Generation , 
is used by the Linkage Loader to determine 
the value of Base Zero.) This location is 
at the top of the Resident Monitor minus 
the Initialization routine or at the top of 
the area reserved for programs under con- 
trol of the Tele-processing Supervisor, if 


Address 
Constant 


5 


No 




tween jobs. 












such an area exists. 





















Figure 6. System Symbols for Communication Region Fields 

The Read routine checks each input record to deter- 
mine whether it is a Monitor control card. If it is, the 
routine branches to the dependent program's end-of- 
file address specified in the linkage sequence. There- 
fore, input records for a dependent program must not 
contain mon$$ in columns 6 through 10. 

The Resident iocs checks for all read errors. 

The linkage sequence for use of the Read routine is 
as follows : 

B /RSl/ 

b (address of end-of-file routine in depend- 

ent program ) 

BBE USERERROR,/MCS/,n 

(Next sequential instruction in the dependent 
program ) 
If the Read routine signals an end-of-file condition, 
it returns control to the branch instruction containing 
the address of the dependent program's end-of-file 
routine. Otherwise, control is returned to the third 
instruction in the linkage sequence. (The third instruc- 
tion, as shown, is optional. ) 



If the Standard Input Unit is tape, a program using 
the Read routine can also check for read errors by 
including the third instruction, as shown. This instruc- 
tion interrogates /mcs/. /mcs/ contains the Channel 
Status Character constructed by the Resident iocs 
from any machine indicators turned on by read errors. 
The Channel Status Character is described in the 
Basic Input/Output Control System publication. 

usererror in the third instruction is the address to 
which control is to be given if an error occurred. The 
contents of n, which must be selected by the user, will 
be compared to /mcs/ to determine if control should 
be given to usererror. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Resident 
Monitor's Read routine: 

ANYLABEL STDIO READ,AREA,EOFADDR,USERERROR,n 

where: 

anylabel is any symbolic label. 
stdio must appear as shown. 
read must appear as shown. 
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area is the high-order address of an 81-character field 
(including a group mark with word mark at the 
end) into which the record is moved. This area 
must be defined by the dependent program. 

eofaddr is the address in the dependent program to 
which control passes when end of file occurs. 

usererror (optional) is the address in the dependent 
program to which control is to be given if an 
error occurs. 

n (optional) is the character to which /mcs/ will be 
compared to determine if control should be given 
to usererror. The user must specify the contents 
of n. 



Print Routine 

The Print routine writes 132-character records on 
the Standard Print Unit. The Print routine can be 
addressed by two types of linkage sequences. One 
requests a print operation using one-area logic; the 
other requests a print operation using two-area logic. 
Both linkage sequences include the address of the 
output area(s) containing the record(s) to be written 
on the Standard Print Unit. 

Note: Only one record will be written per entry to 
this routine. 

Each output area must be defined by the dependent 
program, and each must be 134 positions long. The 
first position of the area is used to specify the carriage- 
control character. (See Figure 7 for the carriage-con- 
trol characters. ) Positions 2 through 133 of the output 
area contain the record to be written on the Standard 
Print Unit. ( If the Standard Print Unit is tape, the first 
position of the output area is also written.) Position 
134 of the output area must contain a group mark 
with word mark. 

The two types of linkage sequences for using the 
Print routine are as follows. 

One Output Area: 
bxpa /prt/ 

DCW #5 

dcw (high-order address of the output area) 

(Next sequential instruction in the dependent 
program) 

Two Output Areas: 

bxpa /prt/ 

dcw #5 

dcw ( high-order address of one output area ) 

dc (high-order address of the other output 

area) 
(Next sequential instruction in the dependent 
program ) 
Note: The dcw of five blanks (immediately below 
the branch instruction) is used for internal functions 



d 


IMMEDIATE 


d 


SKIP AFTER 


d 


IMMEDIATE 


SKIP TO 


PRINT TO 


SPACE 


1 


Channel 1 


A 


Channel 1 


blank 


1 Space 


2 


Channel 2 


B 


Channel 2 


K 


2 Spaces 


3 


Channel 3 


C 


Channel 3 


L 


3 Spaces 


4 
5 


Channel 4 
Channel 5 


D 
E 


Channel 4 
Channel 5 










6 


Channel 6 


F 


Channel 6 


d 


SPACE AFTER 
PRINT 


7 
8 


Channel 7 
Channel 8 


G 
H 


Channel 7 
Channel 8 






/ 


1 Space 


9 


Channel 9 


1 


Channel 9 


S 


2 Spaces 





Channel 10 


? 


Channel 10 


T 


3 Spaces 


# 


Channel 11 


• 


Channel 11 






@ 


Channel 12 


□ 


Channel 12 







Figure 7. Carriage-Control Characters for Print Routine 

of the Print routine. This field must be included in 
every linkage sequence to the Print routine. 

By testing for a word mark in the position immedi- 
ately following the dcw that contains the address of 
the output area, the Print routine determines which 
type of linkage sequence is being used. If a word mark 
is present, it is assumed to be the word mark over the 
operation code of the next instruction in the dependent 
program. If no word mark is present in that position, 
as with the dc, the Print routine assumes the presence 
of an address for a second output area. 

Note: If only one output area is specified, the posi- 
tion following the address of the output area must 
contain a word mark. 

If two output areas are specified, the Print routine 
first uses the output area originally specified by the 
dcw. After completion of each print operation, the 
routine rotates the two addresses in the linkage se- 
quence. Before the first print operation, the linkage 
sequence would appear as follows: 
bxpa /prt/ 

DCW #5 



DCW 



xxxxx 



dc yyyyy 

After the first print operation, the linkage sequence 
would appear as follows : 
bxpa /prt/ 

DCW #5 

dcw yyyyy 

DC XXXXX 

The next time the Print routine is addressed by this 
linkage sequence, it will use the output area repre- 
sented by yyyyy. After that print operation is com- 
pleted, the two addresses are rotated again. 
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If the printed output is to start on a new page, the 
first data record must have a "1" as the carriage-control 
character. If the last data record of the printed output 
is to be the last line printed on a page, one additional 
record of blanks, with a "1" as the carriage-control 
character, should follow the last data record. 

The Resident iocs checks for all print errors (or 
write-tape errors, if tape is used), except for wrong- 
length records written on tape. The POW program 
prints only 133-character tape records. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Print 
routine: 



ANYLABEL 



STDIO 



PRINT,AREA1,AREA2 



where: 

anylabel is any symbolic label. 

stdio must appear as shown. 

pbint must appear as shown. 

areai is the high-order address of a 134-position field 
from which the record is to be printed. The first 
position of the field specifies the carriage-control 
character (see Figure 7). Positions 2 through 133 
contain the record to be printed. Position 134 
contains a group mark with word mark. 

AREA2 (optional) specifies a second output area with 
the same format as areai. 

Punch Routine 

The information concerning the Print routine also 
applies to the Punch routine with the following 
exceptions: 

1. The Punch routine writes 80-character records on 
the Standard Punch Unit. The output area(s) for 
these records must be 81 positions long. (Position 81 
must contain a group mark with word mark. ) 

2. The system symbol used in the bxpa instruction 
is /pch/. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Punch 
routine: 



ANYLABEL 



STDIO 



PUNCH,AREA1,AREA2 



where: 

anylabel is any symbolic label. 
stdio must appear as shown. 
punch must appear as shown. 

areai is the high-order address of an 81-position field 
from which the record is to be punched. Position 
81 must contain a group mark with word mark. 
area2 (optional) specifies a second output area with 
the same format as areai. 
The Resident iocs checks for all punch errors (or 
write-tape errors, if tape is used), except wrong- 
length record written on tape. The POW program 
punches only 80-character tape records. 



Use of Console Inquiry Routine 

Through the Console Inquiry routine, a dependent 
program can request input from the console printer, 
enter a waiting loop while the operator types in the 
information, and then retrieve the input. 
The linkage sequence for console input is: 

bxpa /mcb/ 

dcw /mci/ 

dcw ( address of a blank) 

dcw (address of dependent program's error 

routine ) 

ioctl type,message 



bce 



*-ii,/mci/ 



(Next sequential instruction in the dependent 
program. This instruction should move the con- 
sole input from /riq/ to a field in the dependent 
program. ) 

message is the label for a console printer message 
coded in the dependent program. This message is 
typed to request that the operator enter a $3x mes- 
sage. Then the sequence enters a waiting loop that is 
broken when the $3x message is entered. 

The typed-in message begins with $3x. The x is 
moved to a one-character field designated /mci/. 
/mci/ is cleared to blank by the Console Inquiry 
routine, before it requests the input, and by the End- 
of -Program routine. 

The high-order position of the console input area is 
designated /riq/. Thus, the character "$" is at the 
address designated by /riq/, "3" is at the address desig- 
nated by /riq/ + i, etc. The input area length is defined 
at System Generation; it can be five positions mini- 
mum to 20 positions maximum. In a Tele-processing 
system, the input message area must be 20 positions 
long. Wrong-length-record errors are ignored by the 
Console Inquiry routine. 

The input area is not cleared by the Console Inquiry 
routine. Because a following console message might 
overlay the $3x message, the dependent program 
should immediately move the message from the input 
message area and compare the $3x in the message to 
the x in /mci/ to verify that the message retrieved is 
the correct one. 

Use of Wait-Loop Routine 

When a dependent program requires that processing 
be suspended until the machine operator performs a 
function (such as changing forms in the printer), the 
program can write a message on the console printer 
and then enter the Wait-Loop routine. When the oper- 
ator has performed the function specified by the pro- 
gram's message, he breaks the waiting loop by means 
of console inquiry $50. The Resident Monitor then 
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returns control to the dependent program at the in- 
struction immediately following the branch to the 
Wait-Loop routine. 

The entry point to the Wait-Loop routine is repre- 
sented by the system symbol /wat/. In Autocoder, 
the instruction b /wat/ is used to enter the routine. 
cobol generates this branch from the stop (literal) 
statement. Fortran generates this branch from the 
pause statement. 

In a Tele-processing system, the system can receive 
interrupts during the waiting loop. 

An option in the Wait-Loop routine can cause a 
halt rather than execute a waiting loop every time a 
branch is made to the /wat/ entry point. If this option 
is chosen, it is specified at system generation time. 
The halt is broken by the operator by: 

1. Pressing inquiry request 

2. Pressing start 

3. Entering the class A message $50 



Use of Load Routine 

The Load routine in the Resident Monitor can be used 
by dependent programs to locate and load phases of 
a multiphase program. 

The linkage sequence to request locating, loading, 
and execution of a specific phase is as follows : 
b /lod/ 

dcw + nnn 
When the phase number, nnn, contains a plus sign 
over the units position, the Load routine initiates exe- 
cution of the phase at its entry point. 

The linkage sequence to request only locating and 
loading of a specific phase is as follows: 
b /lod/ 

dcw —nnn 

(Next sequential instruction in dependent pro- 
gram) 
When the phase number, nnn, contains a minus sign 
over the units position, the Load routine returns con- 
trol to the next sequential instruction following the 
linkage sequence that issued the request for the phase. 
The following considerations should be observed in 
using linkage sequences to request program phases: 

1. Requests can be issued only for phases of the 
program being executed. (The name of the program 
being executed is contained in the /pnm/ field of the 
Communication Region. ) 

2. The number of the phase being executed is con- 
tained in the /phn/ field of the Communication Re- 
gion. Using this field, the dependent program can 
construct a request for a specific phase in relation to 
the phase being executed. 



3. If the requested phase cannot be located, control 
is given to the Resident Monitor's End-of-Program 
routine at the unusual-end-of-program entry point. 
The requested phase must be on the System Operating 
File or Job file, as specified in the exeq card for the 
program. (Details concerning end-of -program pro- 
cedures are in the topic "Use of End-of-Program 
Routine." Details on the exeq card are in the section 
"Use of Transitional Monitor." ) 

4. As a phase is brought into storage, it overlays all 
information in the previous phase that falls inside the 
new phase's lowest and highest loading addresses. 
Therefore, information to be communicated from one 
phase to the next must reside below the lowest address 
into which information is loaded for a succeeding 
phase, or above the highest address. 

For a tape-oriented Resident Monitor, dependent 
programs can use subroutines in the Load routine to 
read, backspace, rewind, and search the Job file or 
System Operating File, whichever was specified in the 
Monitor exeq control card for the program. For a disk- 
oriented Resident Monitor, dependent programs can 
use a subroutine in the Load routine to read the Job 
file or System Operating File, whichever was specified 
in the exeq card for the program. 



Read System Tape Subroutine 

This subroutine reads the next record from the Job file 
or System Operating File into the area designated in 
the linkage sequence. The input area must be defined 
by the dependent program. Wrong-length-record er- 
rors are not checked. If the subroutine detects the 
end of file, the file will be rewound and opened with 
label checking, if labels exist, and the first data record 
after the label will be read into the designated area. 

The linkage sequence for the Read System Tape 
subroutine is: 

bxpa /zrr/ 

dcw (@l@ for Load mode or @m@ for 

Move mode ) 

dcw ( input area address ) 

BBE USERERROR,/ZRS/,n 

(Next sequential instruction in the dependent 
program ) 

The fourth instruction is optional. It will give con- 
trol to a dependent program error routine labeled 
usererror if an error occurred. The user must select 
the contents of n to match the error conditions to be 
checked, /zrs/ contains the Channel Status Character 
constructed by the Resident iocs from any machine 
indicators turned on by read errors. 

The following Autocoder macro-instruction can be 
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used to generate the linkage sequence to the Read 
System Tape subroutine: 

ANYLABEL SYSIO READ,X,AREA,USERERROR,n 

where: 

anylabel is any symbolic label. 

sysio must appear as shown. 

read must appear as shown. 

x must be an L for Load mode or an M for Move 

mode. 
area is the high-order address of the area into which 

the record is to be read. This area must be defined 

by the dependent program. 
usererror (optional) is the address in the dependent 

program to which control is to be given if an 

error occurs, 
n (optional) is the character used for comparison to 

determine if an error occurs. The user must select 

the contents of n. 

Backspace System Tape Subroutine 

This subroutine backspaces one or more records, as 
specified in the linkage sequence, on the Job file or 
System Operating File. The subroutine will backspace 
over tape labels, treating them as data records. 

The linkage sequence for the Backspace System 
Tape subroutine is: 

za (number of records to be backspaced, 

minus one ) , xi3 

B /ZBS/ 

(Next sequential instruction in the dependent 
program ) 
The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Back- 
space System Tape subroutine: 

ANYLABEL SYSIO BSP,X 

where: 

anylabel is any symbolic label. 

sysio must appear as shown. 

bsp must appear as shown. 

x is the number of records to be backspaced. 

Rewind System Tape Subroutine 

This subroutine closes and opens, with rewind and 
label checking if applicable, the Job file or System 
Operating File, whichever was specified in the exeq 
card for the program. 

The linkage sequence for the Rewind System Tape 
subroutine is: 
b /zrw/ 

(Next sequential instruction in the dependent 
program ) 
The following Autocoder macro-instruction can be 



used to generate the linkage sequence to the Rewind 
System Tape subroutine: 

anylabel sysio rwd 
where : 

anylabel is any symbolic label. 
sysio must appear as shown. 
rwd must appear as shown. 

Simple Search Subroutine (Tape or Disk) 

This subroutine locates but does not load the re- 
quested phase of the program being executed. If the 
phase is not located, control is transferred to the not- 
found address specified in the linkage sequence. 

The linkage sequence for the Simple Search sub- 
routine is : 

B /ZSS/ 

dcw (three-position unsigned phase number) 

dcw (address of dependent program routine 

to be given control if phase is not found ) 
(Next sequential instruction in dependent pro- 
gram) 
The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Simple 
Search subroutine: 

SEARCH,nnn,NOTFNADDR 



ANYLABEL 



SYSIO 



where: 

anylabel is any symbolic label. 

sysio must appear as shown. 

search must appear as shown. 

nnn is the unsigned, three-digit number of the phase 
to be found. 

notfnaddr ( optional ) is the address in the dependent 
program to which control is to be given if the 
phase is not found. If omitted, control will be 
returned to the instruction after the macro- 
instruction. 

Read System Disk Subroutine 

This subroutine reads a record from the System 
Operating File or Job file in a disk-oriented Operating 
System. The subroutine reads in Load mode. The 
input area is defined by the Resident Monitor; the high- 
order position is /mbf/ and the low-order position 
(one position to the left of the terminating group 
mark with word mark) is /mbx/. 

The linkage sequence for the Read System Disk 
subroutine for a specific track (to be read from the 
System Operating File or Job file, whichever is speci- 
fied in the exeq card) is: 

bxpa /zrr/ 

dcw ( four-character track address ) 

BBE USERERROR,/zRS/,n 

(Next sequential instruction in dependent pro- 
gram) 
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The linkage sequence to read the next track from 
the System Operating File or Job file, whichever is 
specified in the exeq card, is: 

bxpa /zrr/ 

DCW @N@ 

BBE USERERROR,/ZRs/,n 

(Next sequential instruction in dependent pro- 
gram ) 

usererror is the label of an error routine in the 
dependent program, /zrs/ contains the Channel Status 
Character constructed by the Resident iocs from any 
machine indicators turned on by read errors. The user 
must select the contents of n to match the error con- 
ditions to be checked. 

The following Autocoder macro-instruction can be 
used to generate the linkage sequence to the Read Sys- 
tem Disk subroutine. The forms of the macro-instruc- 
tion to read a specific or the next track are: 

ANYLABEL SYSIO READ„nnnn,USERERROR,n 

ANYLABEL SYSIO READ,„USERERROR,n 

where: 

anylabel is any symbolic label. 

sysio must appear as shown. 
read must appear as shown. 

nnnn specifies the four-digit track address of the rec- 
ord to be read. If omitted, the next sequential 
track will be read. (Omission must be indicated 
by a comma, as shown in the second form above. ) 

usererror (optional) is the address in the dependent 
program to which control is to be given if an 
error occurred. 

n (optional) is the character to be used for compari- 
son to determine if an error occurred. The user 
must select the contents of n. If a comma is 
used for this operand, write it as: @, @. If a 
commercial at ( @ ) sign is used for this operand, 
write it as : @ @ . 
Note: Commas must appear as shown. 



Use of End-of -Program Routine 

Dependent programs can end execution in one of 
three ways: normal end of program, unusual end of 
program, or special end of program. The results of the 
three end-of-program types are summarized below. 



END OF PROGRAM NOT TEST MODE 

Special entry 
point: /eop/; 
A-bit of 

/CGO/ ON 



TEST MODE 



Skip to next job 
card. 



END OF PROGRAM NOT TEST MODE 



Normal entry 
point: /eop/ 



Continue process- 
ing with the next 
Monitor control 
card. 



TEST MODE 

Continue process- 
ing with the next 
Monitor control 
card. 



Continue process- 
ing with the next 
Monitor control 
card. However, 
Linkage Loader 
will not be loaded 
and executed and 
programs on the 
Job file will not be 
executed, if re- 
quested. 

Unusual entry Write contents of Write contents of 
point: /uep/ storage on Core storage on Core 
Image file, if this Image file, if this 
file was specified at file was specified at 
System Generation System Generation 
and currently has a and currently has a 
unit assigned to it. unit assigned to it. 
Skip to next job Continue process- 
card, ing with next Mon- 
itor control card. 

The mode is determined by the mode card (de- 
scribed in the section "Use of Transitional Monitor"). 

Note: As the Transitional Monitor skips to the next 
job card, it will process Monitor control cards directed 
to the Tele-processing system and will process a Mon- 
itor end card. 

Note: If the program Snapshot is included at Sys- 
tem Generation, a Snapshot of all core storage is taken 
at /uep/, regardless of mode. 

Normal End of Program 

When a dependent program completes its required 
functions, it signals end of program by branching to 
the Resident Monitor at the entry point represented 
by the system symbol /eop/. This linkage sequence in 
Autocoder language is b /eop/. The Resident Mon- 
itor brings the Transitional Monitor into storage to 
read the Standard or Alternate Input Unit for the next 
Monitor control card. 

Note: The next Monitor control card can be a con- 
trol card indicating the beginning of the next job or 
requesting the performance of another run within the 
current job (such as the execution of a Utility pro- 
gram). Therefore, within one job, the Resident Moni- 
tor can receive any number of end-of-program indi- 
cations. 

Unusual End of Program 

An unusual end of program can be signaled to the 
Resident Monitor in one of three ways: by the de- 
pendent program itself; by the console inquiry $10, 
from the operator; or by having the operator depress 
the program reset key and then the start key. The 
linkage sequence to the unusual-end-of-program por- 
tion of the End-of -Program routine is: 

B /UEP/. 
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When the Resident Monitor receives an unusual- 
end-of -program indication, it preserves the contents of 
storage on the Core Image file (if the installation in- 
cludes such a file ) . The Resident Monitor then checks 
to determine if the dependent program is being tested, 
as indicated by a mode card. If the test mode is not 
on, the Resident Monitor cancels any subsequent por- 
tions of the current job by bringing the Transitional 
Monitor into storage to read the Standard or Alternate 
Input Unit until it finds a Monitor control card that 
indicates the beginning of the next job (job card), 
the end of the current batch ( Monitor end card ) , or a 
card directed to the Tele-processing system. Thus, if 
the program is not being tested, execution of remain- 
ing programs within this job will not be performed. As 
an example, the Core Image file will not be printed, 
even though a storage print was requested by a Moni- 
tor control card requesting execution of the Utility 
programs. 

If the dependent program is being tested, the Tran- 
sitional Monitor is brought into storage to read the 
Standard or Alternate Input Unit for the next Monitor 
control card. If, for example, a storage print is to be 
taken for the program, a Monitor control card that 
requests execution of the Utility programs would be 
placed at this point in the deck. 

Note: Because the contents of core storage is writ- 
ten on the Core Image file only for an unusual end of 
program, and because the Core Image file serves as 
input to the Storage Print program of the Utility pro- 



grams, a dependent program being tested should end 
with a branch to /uep/, rather than /eop/. This en- 
sures that a Storage Print can always be obtained for 
a program being tested, whether it comes to a success- 
ful conclusion or not. 



Special End of Program 

The special end of program is the same as unusual end 
of program, except that the Go and Job file contents 
are indicated as invalid and the contents of storage 
are not written on the Core Image file. Because the 
Go and Job file contents are indicated as invalid, the 
Linkage Loader and any program to be loaded from 
the Job file will not be executed if requested, whether 
the test mode is on or off. ( See the "Use of Transi- 
tional Monitor" section for a description of the mode 
card. ) 

To obtain a special end of program, the dependent 
program must have the following coding sequence to 
set the A-bit of the /cgo/ field on. This sequence must 
be in the coding before the program branches to /eop/. 

bxpa /mcr/ 

dcw /cgo/ 

dcw ( address of an A-bit ) 

dcw (address of dependent program routine 
to be given control if field cannot be 
modified ) 

(Next sequential instruction in the dependent 

program. Usually this instruction is b /eop/.) 
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Information for Dependent Programs 



The following rules are programming requirements 
that must be met by all dependent programs. 

Use of the Resident IOCS 

All programs within the Operating System — those 
supplied by ibm and those that are user-written — use 
the Resident iocs. The Autocoder, cobol, and Fortran 
processors automatically generate the necessary link- 
ages to the Resident iocs, in accordance with the 
input/output statements of each source language. 
( The Autocoder language statements for input/output 
operations are contained in the Basic Input/Output 
Control System publication.) 

No Halts 

Dependent programs must not use programmed halts. 
At end of program, the programs must branch to the 
Resident Monitor's End-of-Program routine. 

Index Registers 

The System Monitor sets a word mark in the high- 
order position of each index register. Group marks 
must not be placed in that position. Dependent pro- 
grams must not clear or set word marks in the index 
registers. 

Each time the Transitional Monitor is brought into 
storage by the Resident Monitor to process Monitor 
control cards, it clears all index registers, but leaves 
the word mark in the high-order position of each regis- 
ter. Transitional Monitor then uses the index registers 
and does not clear them prior to loading a dependent 
program. The signs of index registers are never minus 
after processing of the Monitor control cards. 

Various elements of the System Monitor require in- 
dex registers 14 and 15. Therefore, X14 and X15 must 
not be used by any interruptable instruction sequence 
in a dependent program. If used by a non-interrupt- 
able sequence, X14 and X15 must not be left negative. 

Index register 13 is used for subroutine linkage by 
all programs within the Operating System. (For ex- 
ample, the first instruction in the Resident Monitor's 
Print routine is Store B-Address Register into X13. 
The Print routine then uses the contents of index reg- 
ister 13 for reference to the control information in 
the linkage sequence and for returning to the depend- 
ent program at the instruction following the linkage 
sequence. ) 



Index register 13 should be used for linkage to all 
subroutines introduced into the Operating System by 
the installation. Because of the convention of using 
index register 13 for subroutine linkage, ibm subrou- 
tines do not save and restore the contents of this reg- 
ister. Subroutines introduced by the installation also 
do not need to save and restore its contents. However, 
if a dependent program uses index register 13 for pur- 
poses other than subroutine linkage, it should save the 
contents before issuing a linkage sequence to a sub- 
routine and should restore the contents of the register 
after control is returned from the subroutine. 

If index registers 13, 14, and 15 are used by installa- 
tion programs, they must never be left negative. 

Word Separator Characters 

A word mark should never be set over a word sepa- 
rator character. (A word mark over a word separator 
character would be placed on the Core Image file as 
three word separator characters, but would be read 
from the file into core storage as a word separator 
character with a word mark over the following char- 
acter. ) 

Priority Alert Mode 

Dependent programs should not exit from Priority 
Alert mode, except as specified in the section "Use of 
Resident Monitor Functions," when addressing the 
Resident Monitor (such as in a branch to the Print 
routine ) . 

Unit-Record Interrupts 

A dependent program cannot be initiated by means of 
the Priority Select and priority on switches on the 
console except as noted in the section "Simultaneous 
Peripheral Operation On Line." 

/SIZ/ Field 

A dependent program should have a character in the 
highest core-storage position it will use. This character 
enables the Load routine to properly set the /siz/ field 
of the Communication Region. 

Reading from the Standard Input Unit 

Dependent programs must use the Read routine of the 
Resident Monitor to perform any read operations for 
the Standard ( or Alternate ) Input Unit. 
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Divide Overflow and Arithmetic Overflow Indicators 

Each time the Transitional Monitor is brought into 
storage by the Resident Monitor to process Monitor 
control cards, it turns off the divide overflow and arith- 
metic overflow indicators. 



Two Highest Positions of Core Storage 

The Operating System places group marks with word 
marks in the two highest positions of core storage. 



These group marks with word marks must not be de- 
stroyed by dependent programs. 

System Regeneration 

If the installation regenerates the Operating System 
and if the Resident Monitor in the new System Oper- 
ating File was changed from that in the previous Sys- 
tem Operating File, the Job files produced by the 
previous Operating System cannot be used with the 
new system. 
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Use of Transitional Monitor 



Monitor control cards in the Standard (or Alternate) 
Input Unit direct operation of the System Monitor. 
These cards are read and analyzed by the Transitional 
Monitor. The Monitor control cards are listed in 
Figure 8. 

At System Generation, the installation can specify 
that the System Monitor write each Monitor control 
card on the console printer and/or the Standard Print 
Unit. The installation can also elect at System Genera- 
tion to record all job cards on the Standard Punch 
Unit to help separate punched output. 

Figure 8 shows the format for Monitor control cards. 
The standard Autocoder rules apply to the operands 
of Monitor control cards: 

1. Operands must be separated by a comma. 

2. Operands cannot contain blanks. 

3. An intentionally omitted operand must be indi- 
cated by placing its trailing comma adjacent to the 
preceding comma, except where the omitted operand 
is the last one. 

JOB Card 

The job card indicates the beginning of a job. The 
operand is the name assigned to the job by the pro- 
grammer. 

Upon reading a job card, the Resident Monitor 
closes out the previous job as follows: 

1. It completes any remaining iocs requests. 

2. It clears Communication Region fields: size of 
dependent program field (/siz/), interprogram infor- 
mation field (/ipi/), phase number field (/phn/), 
program name field (/pnm/), and other fields used 
internally, 

3. It turns off the indicators in the /cgo/ field set 
for the operands of the mode card ( described below ) . 

4. If requested, it allows the operator to close, re- 
wind, and unload the tapes for the Standard Print 
Unit, Standard Punch Unit, and Core Image file, to 
permit off-line processing after the previous job is 
completed. ( These indicators are set by $B2, $B3, and 
$B4 console inquiries, which are described in the sec- 
tion "Messages and Inquiries.") 

5. It cancels all Reserve file assignments and all 
assignments of alternate physical units. (See the "As- 
signment of Input/Output Units" section.) 

The Resident Monitor spaces the Standard Print 
Unit to the next page and prints on the Standard Print 
Unit and the console printer one line, which gives: 



1. An "S" or "A" to indicate whether the job card 
was read from the Standard or the Alternate Input 
Unit. 

2. A two-character sequence number that indicates 
the number of job cards that have been read from that 
unit since the beginning of the batch. 

3. The contents of the job card. 

The job card contents and information will be writ- 
ten on the Standard Print Unit and the console printer 
whether or not other Monitor control cards are also 
printed and/or typed. An additional feature, which 
can be specified at System Generation, is the punching 
of job cards on the Standard Punch Unit. 

The System Monitor does not use the operand(s) of 
job cards. However, an installation- written module to 
use the operand(s) can replace the Transitional Mon- 
itor's ibaccount module. 

The ibaccount module, as supplied in the Transi- 
tional Monitor, is a dummy module. After the job 
card is printed and all other job card functions are 
completed, the Transitional Monitor branches to this 
module, which, as supplied, will immediately return 
control to the Transitional Monitor. The installation 
can put into this module accounting routines or any 
other types of routines desired. To replace the dummy 
module with an installation module, see information 
concerning generation of the Transitional Monitor in 
the System Generation publication. 



MODE Card 

This card describes the type of operation wanted in a 
job. The operands for the card are go, test, and sg. 

The go operand may appear on a card with test 
and/or sg operands. The go operand sets the B bit of 
the /cgo/ field on. The B bit is turned off by the next 
job card or the next mode card without a go operand. 

The go operand is used to specify compile-and-go 
operation. If it is specified, the output from following 
compilations will be written on the Go file for subse- 
quent execution within the job. 

If the Go file being used was created any time be- 
fore the last Linkage Loader run, the go mode must 
not be in effect. If the go mode is in effect when a 
previously created Go file is used, the Linkage Loader 
will tape-mark the Go file at the point where the tape 
is when the Linkage Loader execution begins. 

The test operand specifies that following programs 
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Format 


Functions 


Remarks 


Location in 
Control Card Deck 


6 15 


Card 
16 Type 20 


21 Operand(s) 72 


Before first JOB 
card during 
initialization 


MON$$ 


DATE 


yyddd 

yy^Last two num- 
bers in year 
ddd=Three-digit 
number for day of 
the year 


Sets Communication Region 
field /DAT/. 


Must be given in daily information 
cards during initialization of the 
System Monitor, 


Before first JOB 
card during 
initialization 


MON$$ 


SPOOL 


xxyyNNNNNNNN 

NNb 

xx, yy = SPOOL units 

NNNNNNNNNN= 

Name of edit routine. 


Initiate SPOOL 
(Tape parity is 
odd) 


One unit record device (xx) and 
one tape unit [yy) must be 
specified. NNNNNNNNNN 
will be specified only for 
Type II and Type III SPOOL. 


Same as above 


MON$$ 


SPOOB 


Same as above 


Same as above. 


Same as above 


Same as above 


MON$$ 


SPOOU 


Same as above . 


Initiate SPOOL 
(Tape parity Is 


Same as above . 


First card in a job 


MON$$ 


JOB 


ANY NAME AND 
INFORMATION 


Closes out previous job and be- 
gins new job. 


Clears /SIZ/, /IPI/, /PHN/, 
/PNM/. Turns off /CGO/ indi- 
cators for MODE card operands. 


Before EXEQ card 
for program that 
will use symbolic 
unit 


MON$$ 


ASGN 


ABC,XX,YY,ZZ 

ABC=Symbolic 
name for input/ 
output file 

XX,YY,ZZ=As- 
signment symbols 
for any number 
of physical units 


Assigns the symbolic unit in the 
first operand to the physical units 
represented by the assignment 
symbols in the second and follow- 
ing operands. The second operand 
is the base unit and the additional 
operands are alternate units. 


See the section, "Assignment of 
Input/Output Units," for full de- 
tails. 


MON$$ 
MON$$ 


ASGN 
ASGN 


ABC,XYZ 
LIB,SOF 


Assigns the symbolic unit in the 
first operand to the physical units 
for the symbolic unit in the sec- 
ond operand. 


Limited to Work files and Reserve 
files, and to the combination: 
System Library file and System 
Operating File. 


MON$$ 


ASGN 


ABC 


Cancels the assignment previously 
made for the symbolic unit in the 
operand. 




Before EXEQ card 
for program to 
which MODE card 
applies 


MON$$ 
MON$$ 
MON$$ 
MON$$ 
MON$$ 


MODE 
MODE 
MODE 
MODE 
MODE 


GO, TEST 

GO,SG 

GO 

TEST 

SG 


GO operand specifies that lan- 
guage processors write on Go 
file for compile-and-go opera- 
tion. 

TEST operand specifies that rest 
of job is to be executed if pro- 
gram comes to an unusual end. 

SG operand specifies that System 
Generation functions are to be 
performed. (See the System 
Generation publication.! 


MODE card without GO turns GO 
indicator off. 

NOTE: If a previously created Go 
file is being used, do not use MODE 
GO. 

TEST indicator, once turned on, re- 
mains on until next job. 

SG indicator, once turned on, re- 
mains on until System Monitor is 
initialized 


After JOB card 


S 


MON$$ 
MON$$ 


EXEQ 
EXEQ 


NAME1, MJB,XXX 


Initiates search for program in first operand on System Operating File 
(SOF) or Job file (MJB) specified in second operand, then causes it 
to be loaded and executed. 


LINKLOAD, SOF, XXX 
NAME1 for installation 
NAME1 for IBM-provide 

LINKLOAD (Linkage 

AUTOCODER) 

COBOL } 

FORTRAN 1 

SORTDEFINE 

UTILITIES 

SG/} (5ysfe 
TPADLIBGEN ) 
TPATLIBGEN 1 
TPRDLIBGEN | 
TPRTLIBGEN ) 
DSKLIBLDR 
XXX=Symbolic unit whe 
YYY=Name of the Syste 
PROGMNAME=Specifie 
Loader that the progr 
COBOL=Used only for c 
S (in column 1 of EXEQ 


, YYYYYYYYYY, PROGNAME, COBOL 
>rograms is defined by first PHASE card of program, 
d programs can be: 
Loader) 

(language processors) 

(Sort Definition program) 
(Utility programs) 

n Generation programs) 

(Tele-Processing system programs) 

(Disk Library Loader program) 
re input data, source statements, or the control cards are located, 
m Library file for this run of the Linkage Loader. 
s name of program. Inclusion of this parameter tells the Linkage 
am is to be chained. 

lained programs containing subprograms written in COBOL. 
LINKLOAD card)=Linkage Loader memory map not printed. 


Anywhere 


MON$$ 


COMT 


ANY INFORMATION Information in columns 21 through Information is typed and printed, 
TO BE TYPED AND 72 is typed on console printer and whether other Monitor control 
PRINTED printed on Standard Print Unit. cards are similarly recorded or not. 


At end of cards in 
Alternate Input 
Unit and Standard 
Input Unit 


MON$$ 


END 


In Alternate Input Unit, causes If Standard and Alternate Input 
Resident Monitor to resume reading Units are on tape, END card 
from Standard Input Unit, after causes tape to be rewound and 
giving operator opportunity to unloaded, 
close Standard Print Unit, Stand- 
ard Punch Unit, and Core Image 
file. 

In Standard Input Unit, signifies 
end of current series of jobs and 
causes Resident Monitor to enter 
a waiting loop for further in- 
structions from operator. 



Figure 8. Monitor Control Cards 
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are being tested. At unusual end of program, the Resi- 
dent Monitor's End-of-Program routine preserves the 
contents of storage on the Core Image file, if this file 
was specified at System Generation. Then, if test 
mode was specified, the Transitional Monitor, when 
brought into storage, reads the Standard or Alternate 
Input Unit for any Monitor control cards. Thus, a card 
requesting execution of the Utility programs to print 
the Core Image file can be read. If test mode had not 
been specified, the Resident Monitor would cancel any 
remaining portion of the current job. 

If a Utility program storage print is wanted when a 
program under test successfully reaches end of pro- 
gram, the program must branch to /uep/. 

The test indicator, when turned on by a mode card, 
stays on until the next job or until System Monitor 
initialization. 

The sg operand turns the System Generation indica- 
tor on. This operand specifies that a System Generator 
file or System Operating File is being generated, or 
that System Generation maintenance procedures are 
being performed. (See the System Generation pub- 
lication. ) 



EXEQ Card 

The exeq card initiates a search for the named pro- 
gram and causes it to be loaded and executed. Before 
the program is loaded, storage from the locations spec- 
ified in the /org/ field to the top of core minus two 
(/ams/) will be cleared. 

The program to be executed is named in the first 
operand. This program may be an installation pro- 
gram, the Linkage Loader, or other IBM-provided 
programs. The name to be used for an installation pro- 
gram is defined by the first phase card of the program. 

The second operand specifies the file containing the 
program. This operand can be either sof, for the Sys- 
tem Operating File, or mjb, for the Job file. If the 
second operand is omitted, the program is assumed to 
be on the sof. (Omission must be indicated by a 
comma, if additional operands are used.) The Resi- 
dent Monitor's Load routine loads the named program 
from the file specified. 

The third operand, which is optional, changes the 
Resident Monitor's Read routine to read from a sub- 
stitute unit instead of the Standard or Alternate Input 
Unit. After the program is executed, the Read routine 
automatically resumes reading from the Standard In- 
put Unit. This operand cannot be used if the exeq 
card is in the Alternate Input Unit, because the Read 
routine treats the specified unit as a temporary Alter- 



nate Input Unit. This operand can be used only if the 
facility for reading an Alternate Input Unit was incor- 
porated into the Resident Monitor at System Gen- 
eration. 

This operand must be the symbolic name for a Work 
file, Reserve file, the Standard Input Unit, or the Alter- 
nate Input Unit. 

For an installation program, the third operand can 
I specify the location of input data. This file must con- 
I sist of only one reel. ( No Monitor control cards should 
appear in this input data. ) 

For the language processors, the third operand indi- 
cates that the source statements do not immediately 
follow the exeq card. This operand specifies the unit 
containing the source statements. 

For the Linkage Loader, the third operand indicates 
the location of the Linkage Loader control cards. 

The exeq linkload card can have a fourth operand 
to specify the System Library file for this Linkage 
Loader run. In a tape-oriented system, the Linkage 
Loader uses two factors to determine the Library to 
be used: 

1. The fourth operand of the exeq card. If blank, 
the Linkage Loader assumes that the Library is the 
ibm Library (named ibmlibr) on the System Operat- 
ing File. 

2. The asgn card. If absent, the Linkage Loader as- 
sumes that the Library named is on the System Oper- 
ating File. 

Installation programs can specify fourth and suc- 
ceeding operands for use of the program named in the 
EXEQ card. 

When the exeq card contains more than three oper- 
ands, the address of the high-order character of the 
fourth operand is placed in card columns 6 through 10 
in the card input area, overlaying mon$$. No word 
mark is set in column 6. The /cbd/ field contains the 
high-order address of the card input area until the 
next read operation performed by the Read routine. 

The exeq linkload card used for construction of 
chained programs must have a fifth parameter and can 
have a sixth. The fifth parameter, which tells the Link- 
age Loader that the program is to be chained, defines 
the name of the program. The program name can be 
one to ten characters long. The sixth parameter, which 
is the word cobol, is included in the card only if one 
or more of the subprograms is written in cobol. 

An exeq linkload card may have an S in column 1 
to specify that the memory map should not be printed. 
However, the S in column 1 will not suppress the 
printing of diagnostic messages. (See the "Messages 
and Inquiries" section.) 
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COMT Card 

The comt (Comments) card is used to record infor- 
mation on the console printer and the Standard Print 
Unit. All information in columns 21 through 72 of the 
comt card is typed and printed, whether or not other 
Monitor control cards are similiarly recorded. The 
comt card is used to: 

1. Give additional instructions to the operator. 

2. Identify a program's output in greater detail than 
the job card permits. 

ASGN Card 

The asgn card is used to assign input/output units. 
The functions of the asgn card are described in detail 
in the section "Assignment of Input/Output Units." 

END Card 

The end card must be the last card in the Standard 
Input Unit and the Alternate Input Unit. 

When this card is read at the Standard or Alternate 
Input Unit, the Transitional Monitor does the follow- 
ing: 

1. Closes the unit with a rewind and unload, if the 
unit is tape. 

2. Types two messages: end siu (or end aiu) and 
20501 enter b messages. All class B console inquiries 
will be accepted except $B1, which will be ignored if 
the end card was on the Standard Input Unit. ( For an 
end card on the Alternate Input Unit, see item 4.) 
Thus, the operator can close the Standard Print Unit, 
the Standard Punch Unit, and/or the Core Image file. 
During this time, the System Monitor is in a waiting 
loop and Tele-processing system interrupts may occur. 
(See the "Messages and Inquiries" section for details 
on console inquiries.) 

3. Remains in the waiting loop until the $BX in- 
quiry is entered. Then, the Transitional Monitor re- 
sumes reading from the Standard Input Unit, which 
must be on the same physical unit used in the previ- 
ous batch. If the end card was on the Standard Input 
Unit, the Transitional Monitor will ignore all cards 
until it reaches the first job card. Then it will begin 



processing. If the end card was on the Alternate Input 
Unit, the Transitional Monitor resumes processing 
with the next Monitor control card on the Standard 
Input Unit. 

4. If the end card was on the Alternate Input Unit, 
a $B1 inquiry (before the $BX inquiry) will make 
the Transitional Monitor resume reading from the 
Alternate Input Unit. 

Two counters are used to determine the number of 
job cards read since the beginning of a batch. One 
counter is associated with job cards read from the 
Standard Input Unit, the other with job cards read 
from the Alternate Input Unit. Each time an end card 
is read from one of the input units, the counter associ- 
ated with that unit is set to zero. 

DATE Card 

The date card contains the date in its operand. The 
first two positions contain the last two numbers in the 
year, and the next three positions contain the three- 
digit number for the day of the year. 

This card is required in the daily information, which 
is before the first job card, during initialization of the 
Resident Monitor. ( See the Operators Guide publica- 
tion for details on initialization. ) 

The operand is placed in the /dat/ field of the 
Communication Region. 

SPOOL Card 

The spool card is used to assign physical units and 
specify editing routines (if any) for spool operations 
(see $B7 messages in the section "Simultaneous Pe- 
ripheral Operation On Line" ) . When this control card 
is used, it must precede the first Monitor job card at 
initialization. 

PAUSE Card 

When the Transitional Monitor recognizes a pause 
card, processing stops and control passes to the Moni- 
tor wait loop. Enter $50 on the console keyboard to 
continue processing. 
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Simultaneous Peripheral Operation On Line (spool) 
is a programming concept dealing with the concurrent 
execution of card-to-tape, tape-to-card, and tape-to- 
printer operations and a dependent program. In the 
1410/7010 Operating System, spool includes the spool 
control routines, user-written editing routines (if de- 
sired), and spool input/output areas, which are in- 
corporated into Resident Monitor. All tape operations 
are executed in Move mode. Standard iocs error cor- 
rection is provided for all spool operations. 

Three types of programmed control for spool are 
available: 

1. Type I implements normal operations with no 
blocking, deblocking, or editing of records. Label proc- 
essing is that processing specified for system files. 

2. Type II permits inclusion of user-written editing 
routines that contain no input/output operations. 

3. Type HI permits inclusion of user-written editing 
routines containing iocs macro-instructions. 

The selection of one of these three types of spool 
control is made at System Generation. See the System 
Generation publication for procedures and additional 
machine requirements needed to accommodate spool. 



Initialization 



Through Console Inquiries 

The format of the Class B console inquires is: 
I «B?bxxyynnnnnnnnnnb 

where: 

$B7b specifies the operation, but the type of parity is 
| not specified, and xx, yy, and nnnnnnnnnnb have 

the same meaning as above. However, in or- 
der to specify the parity of the tape, it is neces- 
sary to substitute $B7B or $B7U in the place of 
$B7b, where $B7B specifies odd parity and $B7U 
specifies even parity. 
Note: If the parity of the tape has not been speci- 
fied, either through the use of a control card or a 
console inquiry, odd parity is assumed. 

Physical Units 

The two physical units designated for spool operations 
must be a tape unit and a unit-record device. The unit- 
record device must be designated first. The tape unit 
and the unit-record device are assigned to symbolic 
units /stii/ and /sun/, respectively, n designating the 
channel on which the unit-record device is located. 
The two units are disconnected from the system; if 
any job attempts to assign them, the operator is noti- 
fied and can enter an alternate unit for the dependent 
program assignment ( see message 20502 in the Oper- 
ator's Guide publication ) . 



Through Control Cards 

The format of the mon$$ spool control card is : 

mon« SPOOLxxyynnnnnnnnnnb 
where: 

spool specifies the operation but the type of parity is 
not specified 

xx and yy are two physical units 

nnnnnnnnnnb is the name of the editing routine to 
be loaded from the sor. The name need not be 
ten characters, but a blank must be entered after 
the last character of the name. If no editing rou- 
tine is specified ( that is, if the spool control card 
is in the format spooLxxyyb), only Type I spool 
will be performed. In order to specify the parity 
of the tape, it is necessary to substitute spoob or 
spoou in the place of spool, where spoob speci- 
fies odd parity and spoou specifies even parity. 



Initialization Messages to Operator 

Two messages may appear on the console printer dur- 
ing initialization. They are: 

10190 xx 

Explanation: Unit xx is already assigned. 

Action: The operator should re-enter the $B7 inquiry 

using another unit. 

10191 nnnnnnnnnn 

Explanation: The editing routine, nnnnnnnnnn, called 
could not be found. 

Action: The operator may re-enter the $B7 inquiry using 
another routine name. 



Initiation of Operation 

spool operations can be initiated any time after spool 
initialization. The operator uses the following pro- 
cedure: 

1. Ready the appropriate tape on the spool tape 
unit. 



Simultaneous Peripheral Operation On Line 47 



2. Ready the appropriate unit-record device. 

3. Turn the Priority Select Switch on the 1415 con- 
sole to the appropriate position. 

4. Press priority on. This provides the initial inter- 
rupt needed to start spool. 



Operation 

Four messages may appear during spool operations. 

They are: 

10101 mms xx 

Explanation: An error has occurred on unit xx, a SPOOL 
unit-record device. 

Action: The operator should take any necessary correc- 
tive action and press PRIORITY ON twice to resume 
operation. (See Operator's Guide.) 

10192 SIP 

Explanation: An attempt has just been made to assign 
units to a SPOOL supervisor which is currently in 
process. 

Action: The operator can discontinue the current func- 
tions by making certain the PRIORITY ON switch is off, 
entering the release message for the current units 
($B7Rxxyy), and then pressing the PRIORITY ON 
switch. 

10199 EOSn 

Explanation: The SPOOL function has been completed 

on channel n. 

Action: Press PRIORITY ON twice to process another 

file. 

30101 cu 

Explanation: Error in one or more fields in the header 
label of the SPOOL input tape on channel and unit cu. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter $8R ( to retry the label checking ) or 
Enter $8A ( to accept the label as read ) . 

3. Press INQUIRY RELEASE. 



SPOOL Editing Routines 

Editing routines written by the user and specified and 
placed on the System Operating file at System Gen- 
eration ( see the System Generation publication ) must 
conform to the following rules : 

1. The entire routine must be a one-phase program. 

2. Each editing routine must be assembled to load 
at system symbol /sAn/, where n is the channel on 
which the spool unit-record device exists. A basei 
control card is used; i.e., basei /sAn/. 

3. Each editing routine must begin with a fixed pre- 
fix. This is described in the following section. Essen- 
tially, the prefix contains the address of entry points in 
the user's editing routine to which spool control will 
branch. 

4. The size of an editing routine must not exceed 
the size specified at System Generation. 

5. Any iocs macro-instruction can be used within 
any editing routine associated with Type III spool. 



6. If the execution of the editing routines exceeds 
certain specified times, spool does not share the time 
with a batch program. In effect, spool uses the system 
to the exclusion of any other data processing (except 
that of Tele-processing). These times are: 
Card reader 60 milliseconds 

Printer 85 milliseconds 

Card punch 235 milliseconds 

Fixed Prefix 

Each editing routine must begin with the fixed prefix 
described below. The prefix has the following format: 

aaaaabbbbbcccccdddddeeeeefffffggggg 

where: 

aaaaa is the address of an area in the editing routine 
that is used as the input/output area for all tape 
operations. If this field is blank or zero, the unit- 
record area in spool control is used. 

rbbbb is the address of an entry point in the editing 
routine to which spool control branches on a unit- 
record-operation-complete interrupt. When such 
an interrupt occurs, editing, blocking, and other 
operations on the data can be performed. If this 
field is blank, no branch is made. 

ccccc is the address of an entry point in the editing 
routine to which spool control branches on a 
tape-operation-complete interrupt. On such an in- 
terrupt, editing, blocking, and other operations on 
the data can be performed. If this field is blank, 
no branch is made. 

ddddd is the address of a File Table Extension infor- 
mation area (in the editing routine) used for the 
spool tape unit. If this field is blank, label proc- 
essing is bypassed. 

eeeee is the address of an entry in the editing routine 
to which spool control branches immediately be- 
fore opening the spool tape. If this field is blank, 
no branch is made. 

fffff is the address to which spool control branches 
immediately after closing the spool tape. If this 
field is blank, no branch is made. 

ggggg is the address of an entry point in the editing 
routine to which spool control branches immedi- 
ately upon receiving the input end-of-file inter- 
rupt. If this field is blank, no branch is made. 
This part of the editing routine enables padding 
and writing partial records. 

Returning Control to SPOOL 

The editing routine must return control to spool with 
a bxpa in accordance with the following designations: 
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ccccc 



EEEEE 
FFFFF 

GGGGG 



RETURN FROM RETURN POINT 

BBBBB /Sn3/ — to continue with execution of the next 

tape operation. 

/Sn4/ — to skip the tape operation and execute 
another unit-record operation. 

/Snl/ — to continue with execution of the next 
unit-record operation. 

/Sn2/ — to skip the unit-record operation and 
execute another tape operation. 

/SnO/ - return to SPOOL, following OPEN exit. 

/Sn9/ — return to SPOOL if no partial records 

found. 

/Sn8/ - return to SPOOL, following CLOSE exit. 

/Sn3/ — return to SPOOL to write final record. 

The following are additional system symbols used 
in spool control: 

SYMBOL REPRESENTS 

/SnE/ The Channel Status Character in the SPOOL IORW. 
This character reflects the error status of the last 
SPOOL input/output operation. 

/SCn/ The high-order position of the SPOOL card area. 
/SPn/ The high-order position of the SPOOL print area. 
/SKn/ The carriage control character. This control character 

is located at /SPn/ minus one and has a word mark. 
/SFn/ The low-order position of the file list origin field of 

the SPOOL file table (the file table address). 



Programming Considerations 

spool imposes some restrictions on the use of indica- 
tors and entry into Operating System reserved areas. 
These are outlined below. 



TYPE n SPOOL 

Allowed 



TYPE III SPOOL 

Allowed 



Not Allowed Not Allowed 



Allowed if 
user saves 
and restores 
Not Allowed 

Allowed 



Not Allowed 



Allowed in Priority 
Alert mode only if user 
saves and restores. 
Allowed 

Not Allowed when in 
Priority Alert mode. 
Otherwise allowed. 

Allowed 



SUBJECT 

Use of high, low, 
equal, and zero 
balance indicators 

Use of divide check 
and arithmetic over- 
flow indicators 

Use of index registers 
XI through X12 

Use of index register 
X13 

Use of index registers 
X14 and X15 

Entering Priority Alert 
mode 

Entering Resident 
IOCS 

If the user has specified an input/output area 
(aaaaa) in the editing routine, he is responsible for 
moving data between his area and the spool input/ 
output areas. There are no word marks in the card or 
print input/output areas. Both areas are followed by 
a group mark with word mark. 

Extra input/output units may be assigned to spool 
by use of an asgn card. It is recommended that Tele- 
processing symbolic units be used for these assign- 
ments. 

If the address at ddddd is /mlx/, spool will use the 
standard File Table Extension for system files. 



Not Allowed Allowed 
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Assignment of Input/Output Units 



Input/output units are referenced as: 

1. physical units. Physical unit designates all of, or 
sections of, a physical device. Each physical unit is as- 
signed a two-character assignment symbol at System 
Generation. The assignment symbols are selected by 
the installation. 

2. symbolic units. Symbolic unit designates a file to 
be read from or written on a physical unit. Symbolic 
units are referred to by the symbolic names given in 
this section. 

The symbolic unit names are used in the symunit 
entry of the iocs Define the File statement in programs 
( see the Basic Input/ Output Control System publica- 
tion) and in the first operand of the Monitor asgn card. 
The symbolic unit files are assigned to one or more 
physical units by the asgn card and iblookm linkage 
sequence. The assignments are made by assignment 
routines in the Resident and Transitional Monitors. 

To enable an installation to make the most efficient 
use of input/output units for a series of jobs, program 
references to input/output units are made symboli- 
cally. Also, the programmer is freed from concern as to 
which specific input/output units will be available 
when his program is executed 

A physical unit is one of the following: 

1. A reader, punch, printer, or other unit-record 
device 

2. A tape unit 

3. A set of consecutive tracks in a 1301 or 2302 Disk 
Storage module 

Note: The 1402 Card Read Punch must be defined 
for each function. (The read function is specified as 
one physical unit, the punch function as another.) 

The assignment symbols specified for physical units 
during System Generation are placed into a table in 
the Resident Monitor. During operation of the system, 
this table represents the input/output units that are 
available for use by dependent programs and by the 
System Monitor. 

This table can be changed — in terms of additions 
and deletions — only by another System Generation. 
The operator, however, can indicate through $B5 and 
$B6 inquires that a physical unit is not currently avail- 
able for use, or that it is again available. (See the 
"Messages and Inquiries" section for details on console 
inquiries. ) 

Note: Definition of Tele-processing devices is also 
performed during System Generation, but in a differ- 



ent manner. They are defined by specifying the related 
elements of the Tele-processing Supervisor. (See the 
Tele-processing Supervisor publication.) The defini- 
tions of Tele-processing devices are not placed in the 
Resident Monitor's table. However, physical units used 
by programs operating within the Tele-processing sys- 
tem (other than Tele-processing devices) are given 
assignment symbols in the same manner as physical 
units for other programs, and their assignment symbols 
are also placed in the Resident Monitor's table. 

Physical Units 

The following example illustrates one possible set of 
assignment symbols to represent physical units. Since 
any scheme of two-character symbols can be incorpo- 
rated into the System Monitor, each installation can 
designate the set of assignment symbols that best 
suits its needs. 

Channel 1 Tape Units: ao ( A-zero ) through A9 
Channel 2 Tape Units: bo through B9 
Unit-Record Equipment: 
1402 Card Read Punch ( read function ) : ci 

1402 Card Read Punch ( punch function ) : C2 

1403 Printer: C3 

Tracks of Disk Storage (Channel 1, Module 0) : 

0000-0079: di 

0120-0159: ds 

7000-7999: D3 

(Note that although the tracks that constitute each 

physical unit must be consecutive, separate physical 

units need not be consecutive or contiguous.) 
Tracks of Disk Storage ( Channel 1, Module ) : 

4000-8999: ei 

9315-9386: es 

(Note that track assignments need not begin and 

end at cylinders. ) 
Tracks of Disk Storage ( Channel 2, Module ) : 

0000-9999: fi 

Note: Physical unit track definitions may overlap 
each other. 

Symbolic Units 

The symbolic names to be used for symbolic units are 
defined during System Generation, when they are 
placed in the Resident Monitor table. During system 
operation, this table is used in conjunction with the 
table of physical units to assign input/output units for 
program use. 



50 



Symbolic units are divided into five groups, in ac- 
cordance with the type of program that uses the sym- 
bolic unit: 

1. System files are used by the System Monitor. 

2. Work files are used by IBM-provided components 
of the Operating System. 

3. Reserve files are used by installation programs. 

4. Tele-processing system files are used by installa- 
tion programs that operate under control of the Tele- 
processing Supervisor. 

5. SPOOL files are used by the spool Supervisor 
in performing peripheral operations on-line while de- 
pendent programs are being run. 

Note: Work files can also be used by installation 
programs, but care must be exercised to ensure that 
conflicts do not arise between assignments for ibm- 
provided programs and assignments for installation 
programs. 

The symbolic names for the symbolic units are listed 
below. For each System file, the symbolic name is pre- 
determined; for the other four groups of symbolic 
units, the symbolic names are assigned from the specif- 
ic sets by the Operating System at System Generation. 

System files: 

sru — Standard Input Unit 

sof — System Operating File 

spr — Standard Print Unit 

spu — Standard Punch Unit 

aiu — Alternate Input Unit 

lib — System Library file 

mjb — Job file 

mgo — Go file 

mdm — Core Image file 

mlt — tp Library file ( for Tele-processing system ) 

mdt — Temporary Storage file ( for Tele-processing 
system ) 
Work files: 

mwo ( Mw-zero ) through mw9 

mwa through mwz 

Reserve files: 

MRO through MR9 

mra through MRZ 
Tele-processing system files: 

MTO through MT9 

mta through MTZ 
SPOOL files: 
sui — spool Unit-Record Device on Channel 1 
sua — spool Unit-Record Device on Channel 2 
sti — spool Tape Unit associated with the spool 

Unit-Record Device on Channel 1 
st2 — spool Tape Unit associated with the spool 

Unit-Record Device on Channel 2 



Assignment Times for Symbolic Units 

The symbolic units are divided into five categories 
with respect to the times that they can (or must) be 
assigned to physical units: 

1. Symbolic units that are assigned during System 
Generation, initialization, or reinitialization: 

sof ( System Operating File ) 

siu ( Standard Input Unit ) 
Note: The device type for the System Operating 
File cannot be changed at initialization or reinitial- 
ization. 

2. Symbolic units that are assigned during initiali- 
zation or reinitialization of the System Monitor and 
cannot be reassigned, except by initialization or reini- 
tialization procedures: 

spr ( Standard Print Unit: ) 
spu ( Standard Punch Unit ) 
mdm ( Core Image file ) 

Note: Assignment of these units is part of the daily 
information supplied to the System Monitor during ini- 
tialization and reinitialization procedures. These units 
must be assigned if facilities for them were incorpo- 
rated into the Resident Monitor at System Generation. 
However, if the variable print and punch modules are 
selected, these symbolic units may be assigned at 
System Generation, initialization, or whenever the 
Transitional Monitor is called; the units can be re- 
assigned at initialization or between runs in a job. If 
these units are assigned at System Generation, the 
assignments cannot be canceled before the first job 
card. Thus, if the variable print and punch modules 
are chosen, these system files fall into category three. 
In this case, all three (and the Temporary Storage 
file) can share the same tape unit. 

3. Symbolic units that can be assigned during ini- 
tialization or reinitialization procedures and can also 
be assigned or reassigned between each run within a 
job: 

lib ( System Library file ) 
aiu ( Alternate Input Unit ) 
mwx ( All Work files ) 

Note: The Alternate Input Unit cannot be assigned 
by a control card that is read from the Alternate Input 
Unit. The System Library file should not be assigned if 
it is on the System Operating File. Three Work files 
must be assigned for the Autocoder and cobol lan- 
guage processors; the physical units, if tape drives, 
for two of these files should be on one channel and the 
physical unit for the third file should be on the other 
channel, for maximum processor efficiency. The physi- 
cal units, if tape, for the two Work files that must be 
assigned for the Fortran processor should be on dif- 



Assignment of Input/Output Units 51 



ferent channels. (See the Operators Guide publica- 
tion for full details. ) 

4. Symbolic units that are assigned between each 
job: 

mjb ( Job file ) 

mgo (Go file) 

mrx ( All Reserve files ) 
Note: The System Monitor cancels the assignment 
of these units at each job card. These files can be 
assigned (or reassigned) between each run within a 
job. However, care should be taken in reassigning the 
Job and Go files to ensure that the Linkage Loader 
and language processors have the proper input/out- 
put files. 

5. Symbolic units that can be assigned at System 
Generation or at other times when the Tele-processing 
system is not open: 

mlt ( tp Library file ) 
mdt (Temporary Storage file) 
mtx ( All Tele-processing system files ) 
Note: If the Tele-processing system is not open, 
the Temporary Storage file can be shared with the 
Standard Print Unit, the Standard Punch Unit, and 
the Core Image file. The assignment of these units is 
canceled when the total System Monitor is initialized 
or reinitialized. Between initializations (or reinitiali- 
zations) of the total System Monitor, these assign- 
ments are maintained, regardless of the number of 
times the Tele-processing system is opened and closed. 
The assignments can, however, be changed by asgn 
cards each time the Tele-processing system is closed. 

6. Symbolic units that can be assigned only by the 
class B console inquiry $B7 (see the "Messages and 
Inquiries" section ) : 

sui ( spool Unit-Record Device on Channel 1 ) 
su2 ( spool Unit-Record Device on Channel 2) 
sti ( spool Tape Unit associated with the spool 

Unit-Record Device on Channel 1 ) 
ST2 ( spool Tape Unit associated with the spool 
Unit-Record Device on Channel 2 ) 
Note: The assignment of these units is canceled 
when the total System Monitor is initialized or reini- 
tialized. Between initializations (or reinitializations) 
of the total System Monitor, these assignments are 
maintained. However, the assignments can be changed 
by the $B7 console inquiry. 

Program References to Symbolic Units 

After the installation has established the set of sym- 
bolic names for the symbolic units, these names are 
used in installation programs to designate the symbolic 
units for a program's files. For example, in Autocoder, 
the symbolic name is used in the symunit entry of the 



Define the File statement, cobol and Fortran simi- 
larly provide means by which the programmer identi- 
fies symbolic units for a program. 

The Linkage Loader converts the symbolic names 
for the symbolic units into addresses that enable the 
Resident and Transitional Monitors to assign input/ 
output units in accordance with the asgn cards. 

ASGN Card 

The asgn card, which is a Monitor control card, directs 
the System Monitor to assign one or more physical 
units to a particular symbolic unit. 

As shown in Figure 9, the first operand of an asgn 
card is the symbolic name for the symbolic unit. The 
second operand is the assignment symbol for the first 
physical unit (the base unit) to be assigned to that 
symbolic unit. Additional operands can be used to 
specify alternate units. 

In Figure 9, ai is the base unit; A2 and A3 are the 
alternate units. When end of unit is reached for ai, 
the next input/output operation for mri will be per- 
formed with the physical unit represented by A2. ( For 
tape, end of unit is determined by reaching end of 
reel; for disk, end of unit is determined by reaching 
the end of the set of tracks that constitute one physical 
unit. The use of alternate units does not apply to unit- 
record equipment.) 

At the end of unit for A2, the next input/output 
operation for mri will be performed with the physical 
unit represented by A3. The end of unit for A3 is con- 
sidered end of file for the symbolic unit mri, if mri 
represents a disk file. However, if mri represents a 
tape file, continuous cycling of the physical units is 
performed. Thus, ai would be the fourth physical unit 
used. In such a case, end of file is determined by reel 
counts, trailer labels, or end-of-reel conditions (for 
unlabeled tapes). 
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Figure 9. Format of the asgn Card 

A physical unit can be assigned to more than one 
symbolic unit at the same time. For example, a job 
involving a compile-and-go operation could use a tape 
unit as a Work file for the language processor and then 
use the same unit as a Reserve file for the program 
that was just compiled. The asgn cards for the two 
symbolic units can both be placed immediately behind 
the job card for this job. The System Monitor makes 
the assignments as the asgn cards are read, but since 
assignments are not used until a program initiates an 
input/output operation through the iocs, no conflict 
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occurs because of the dual assignment. Figure 10 illus- 
trates the use of two asgn cards to assign the same 
physical unit to different symbolic units. 
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Figure 10. Assignment of Two Symbolic Units to the Same 
Physical Unit 

Note that all symbolic units that share a base unit 
also share any alternate units specified for that base 
unit. The physical units are shared in the same order. 
A base unit assigned to one symbolic unit cannot be 
assigned to another symbolic unit as an alternate unit. 
(For example, these two assignments cannot exist 
simultaneously: mri,ai,a2 and MR2,A2.) However, if 
an alternate unit must be assigned as the base unit of 
another symbolic unit later in the job ( or vice versa ) , 
the initial assignment must be canceled. If a base unit 
assigned to one symbolic unit is subsequently assigned 
to another symbolic unit, all alternate units assigned 
to the first symbolic unit are also shared by the second. 
However, if in the second assignment, an alternate 
unit not named in the first assignment is specified, 
that alternate will be ignored by the Monitor. 

Cancellation of Assignment 

Symbolic unit assignments are canceled by an asgn 
card containing only the first operand. For example, 
the asgn card in Figure 11 cancels the assignment for 
the Reserve file mri. This cancellation permits the 
physical units previously assigned to mri to be used 
for another file. 
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Figure 11. Cancellation of Assignment 

The asgn card in Figure 11 and the asgn card used 
to assign mri's physical units to the next file should 
both be placed immediately before the exeq card for 
the program that uses the next file. (The card that 
cancels the assignment to mri must precede the card 
that makes the new assignment of the physical units. ) 

Placement of the ASGN Card 

The asgn cards are submitted to the System Monitor 
through the Standard (or Alternate) Input Unit. The 
position of an asgn card in the control card deck is 
determined by the category of symbolic unit named 
in the asgn card. 

Asgn cards for symbolic units that are assigned dur- 
ing initialization or reinitialization are in the daily in- 
formation in the Standard Input Unit. 



asgn cards for symbolic units that are assigned only 
for the duration of a job must follow the related job 
card and precede the exeq card for the program that 
uses the files. 

asgn cards for symbolic units that are used by the 
Tele-processing system must precede the control card 
or the console inquiry that opens the Tele-processing 
system. 

Use of the ASGN Card for System Files 
The physical units assigned to certain System files can- 
not be assigned to any other symbolic units during the 
time they are assigned to the System files. These Sys- 
tem files are: 

sof ( System Operating File ) 

siu ( Standard Input Unit ) 

spr ( Standard Print Unit ) 

spu ( Standard Punch Unit) 

lib ( System Library file) 

mdm ( Core Image file ) 

aiu ( Alternate Input Unit ) 

mlt (tp Library file) 

mdt ( Temporary Storage file ) 
In addition, physical units assigned to symbolic 
units used by the Tele-processing system cannot be 
assigned to any other symbolic units when the Tele- 
processing system is ready to receive input from Tele- 
processing devices. 

The physical units assigned to the System Operating 
File and the Standard Input Unit can be reassigned to 
other symbolic units only through System Generation, 
initialization, or reinitialization. The physical units as- 
signed to the Standard Print Unit, the Standard Punch 
Unit, and the Core Image file can be reassigned to 
other symbolic units only through initialization or re- 
initialization. If the variable print and punch modules 
are selected, these system files can also be reassigned 
by an asgn card during run time. The physical unit 
assigned to the System Library file (if this file is not 
part of the System Operating File) can be reassigned 
to other symbolic units either through initialization 
and reinitialization or through cancellation of the Li- 
brary's assignment by an asgn card containing lib as 
the only operand or containing the operands sof,lib. 
| System files must consist of only one reel. 

For compile-and-go operations, the Go file must not 
be assigned to a physical unit used for the language 
processor's Work files. 

System File Sharing and Device Switching Feature 

The device switching feature allows the device type 
of the Standard Print Unit and the Standard Punch 
Unit to be changed by an asgn card. This asgn card 
can be placed before the first job card in the deck or 
between runs in a job. The device switching feature 
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for the Standard Print Unit is selected by choosing 
the Variable Print module. This selection is made by 
specifying 3 in parameter 1, field P of the genos card 
(see the System Generation publication for an expla- 
nation of the genos card). Device switching for the 
Standard Punch Unit is made by selecting the Vari- 
able Punch module. This module is selected by speci- 
fying 3 in parameter 1, field R of the genos card. The 
device switching feature, if desired, must be selected 
for both the Standard Print Unit and the Standard 
Punch Unit. 

If device switching is requested, one tape unit can 
be shared by the Standard Print Unit, Standard Punch 
Unit, Core Image file, and Temporary Storage file. 
Assignment of these files can be made during System 
Generation, at initialization, or between each run in 
a job. These assignments are permanent unless an- 
other asgn card is processed or the system is reinitial- 
ized. 

Because reassignments are made as they are re- 
quested in the program, care should be taken when 
both the Standard Print Unit and the Standard Punch 
Unit are reassigned. There are no look-ahead pro- 
visions; hence, different logical results may occur. For 
example, the first assignment for the Standard Print 
Unit and the Standard Punch Unit might define both 
files on the same tape unit, A6. In reassigning these 
files, two of the options are: 

(1) MON$$ ASGN SPR,A5 
MON$$ ASGN SPU,A6 

(2) MONSS ASGN SPU,A6 
MON$$ ASGN SPR,A5 

If the first option is used, the Standard Print Unit is 
assigned to A5 when the first card is processed. A6 
remains open to preserve the original assignment of 
the Standard Punch Unit. When the second card is 
processed, A6 is rewound and unloaded. A new Stand- 
ard Punch Unit is defined on another tape, A6. Three 
physical tape reels are involved in this reassignment: 
the original assignment for the Standard Print Unit 
and the Standard Punch Unit placed these files on A6; 
the Standard Print Unit was reassigned to A5; and the 
Standard Punch Unit was reassigned to a new A6. 

If the order of the assignment is reversed, as in the 
second option, only two physical tape reels are used. 
After the first card is processed, no change occurs to 
A6. When the second card is processed, a new printer 
file is defined on A5. A6 still contains the Standard 
Punch Unit. 

When tape-to-tape reassignment of the Standard 
Print Unit and the Standard Punch Unit is made with- 
in a job, three conditions are possible: 



1. If the Standard Print Unit and the Standard 
Punch Unit are assigned to the same output tape, and 
either the Standard Print Unit or the Standard Punch 
Unit is later reassigned to the same output tape, this 
tape will not be rewound. 

2. If the Standard Print Unit and the Standard 
Punch Unit are assigned to the same output tape, 
and either the Standard Print Unit or the Standard 
Punch Unit is later reassigned to a different tape unit, 
the following results occur: 

a. The mixed output tape will not be rewound. 

b. The reel on the physical unit that is called for 
by the new assignment will be rewound when the 
unit is opened. A copy of pow will be written if 
it was specified during System Generation (see 
the genos card). 

3. If the Standard Print Unit and the Standard 
Punch Unit are not assigned to the same tape unit, 
and a reassignment of either file is made, the follow- 
ing results occur: 

a. The tape unit to which the file was first as- 
signed will not be rewound and unloaded. 

b. The reel on the physical unit that is called for 
by the new assignment will be rewound when 
the unit is opened. A copy of pow will be written 
if it was specified during System Generation. 

Note: If reassignment of the Standard Print Unit 
and the Standard Punch Unit puts both files on the 
same tape, the resultant mixed tape will not be re- 
wound. 

In the event that the system is reinitialized and no 
assignment is made for the Core Image file, a sub- 
sequent checkpoint or dump will cause the check- 
point or dump routine to be entered. However, noth- 
ing will be written on the Core Image file. 

If the Core Image file is shared with any other 
system file, either in the current run or in the current 
batch, a utility storage print cannot be executed from 
the Core Image file. To obtain a storage print from a 
shared tape, that tape must be assigned to mwo. 

For example, the Standard Print Unit, the Standard 
Punch Unit, and the Core Image file share A8 and a 
storage print is requested. The following assignments 
could be made: 

mon$$ asgn mdm the mdm assignment 

is canceled 



MON$$ ASGN SPR,A7 



MON$$ ASGN SPU,SPR 



MON$$ ASGN MW0,A8 



the spr is reassigned 
to A7 

the spu is reassigned 
to A7 

the shared tape, as, 
is assigned to mwo 
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MON$$ EXEQ UTILITIES 

dump core,mwo,all,„u a storage print 

is given for all 
core dump rec- 
ords on the 
shared tape, 
i.e., A8 
Before as is assigned to mwo, it is rewound and un- 
loaded. It must be reloaded before the storage print 
can be executed. 

When restarting from a checkpoint, a function of 
the restart program is to reposition the system files. 
If the system files are on a shared tape, the tape 
might not be repositioned correctly. This will happen 
if all the files on the shared tape except the Standard 
Print Unit or the Standard Punch Unit have been re- 
assigned. For example, assume that the first assign- 
ments for the system files were: 

MON$$ ASGN SPR,A7 

MON$$ ASGN SPU,A7 

MON$$ ASGN MDM,A7 

MON$$ ASGN MDT,A7 

Before a checkpoint is taken, the following reassign- 
ments are made: 

MON$$ ASGN SPU,A8 

MON$$ ASGN MDT,A8 

If a restart is called for, A7 will be repositioned cor- 
rectly because the Standard Print Unit and the Core 
Image file are still on A7. However, assume that in- 
stead of the above reassignments, the following re- 
assignments are made: 

MON$$ ASGN SPR,A8 

MON$$ ASGN MDM,A8 

MON$$ ASGN MDT,A8 

If a restart is called for, A7 will not be repositioned 
correctly because the block count for repositioning 
reflects only the Standard Punch Unit records. Since 
the records of the four system files have been inter- 
spersed on A7, and since the tape will be repositioned 
according to the block count of the Standard Punch 
Unit only, a number of records (including Standard 
Punch Unit records) will be lost. For example, A7 
has the following format: 



Block 
Number 1 



where a is the position of the tape before the restart 
and b is the position of the tape after repositioning. 
The Standard Punch Unit block count is three. If a 
restart is called for, A7 will be repositioned (back- 
spaced three blocks to block 7). The record prior to 
block 7 will be lost. A7 can be repositioned to correct 
the block count only by reassigning the Standard 
Punch Unit to A7, i.e.: 



MON$$ 


ASGN 


SPR,A8 


MON$$ 


ASGN 


MDM,A8 


MON$$ 


ASGN 


MDT,A8 


MON$$ 


ASGN 


SPU,A7 



Linkage Sequence for Assignment of Symbolic Units 

Through the iblookm linkage sequence, a dependent 
program during its execution can set the symbolic unit 
selection for any Reserve file, Work file, or Tele-proc- 
essing system file. Using this sequence, the dependent 
program is written to operate with any symbolic unit. 
It is stored in absolute format in the System Operat- 
ing File. If this sequence were not used, the program 
would have to be processed by the Linkage Loader 
each time to resolve the one symbolic unit entry that 
would change with each execution. 
The linkage sequence is: 



DCWS 
DCW 



DCW 



IBLOOKM 



}SYM( 



FILE 



b ( address of dependent program instruc- 

tion to which control is to be given if 
symbolic unit requested is not a Re- 
serve, Work or Tele-processing system 
file or does not exist) 
(Next sequential instruction in dependent pro- 
gram) 
where: 
sym = The symbolic name of the symbolic unit to 

be used by the dependent program. 
file = The label used in the Define the File Header 
Line for the corresponding file. 
Note: The iblookm module must be on the cur- 
rently assigned System Library file. 

To use this sequence, a control card can be read 
during program execution to supply the information 
for the sym operand. Such a program could be a Util- 
ity program written to print any tape file. 
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Messages and Inquiries 



During operation, the System Monitor types informa- 
tion and diagnostic messages on the console printer 
and/or prints them on the Standard Print Unit. If an 
installation does not specify a Standard Print Unit at 
System Generation, it will not receive certain informa- 
tion and messages that are printed only on the Stand- 
ard Print Unit. 

The System Monitor can also receive inquiries 
through the console printer. 



Memory Map 

The Linkage Loader will write information on the 
Standard Print Unit to provide a memory map of the 
program being relocated. This memory map informa- 
tion will be interspersed with Linkage Loader diag- 
nostic messages. 

The column headings printed at the top of the mem- 
ory map are: 

MESSAGE CARD NAME VALUE SYMBOL VALUE SYMBOL 

VALUE SYMBOL VALUE SYMBOL VALUE SYMBOL VALUE 

All Linkage Loader error messages will begin in the 
message column. 

The card column contains the name of the following 
five key Linkage Loader control cards in the order in 
which they are processed. All information about each 
card will be printed on one line. 

PHASE Card: The word phase will appear in the 
card column. The program name will appear in the 
name column for a phase card with an operand; for a 
blank-operand phase card, the name column will be 
blank. The upward relocation factor for the phase will 
be printed in the leftmost value column. Note that if 
a basei card is processed after the phase card, but be- 
fore any load cards, the value column of the phase 
card line will not be accurate. 

BASEI Card: The word basei will appear in the 
card column. The leftmost value column will contain 
the new upward relocation factor. 

BASE2 Card: The word base2 will appear in the 
card column. The leftmost value column will contain 
the new downward relocation factor. 

PRTCT Card: The word prtct will appear in the 
card column. The leftmost value column will contain 
the new protection value for the Linkage Loader sym- 
bol table. 

TITLE Card: The word title will appear in the 



card column. The subprogram name will appear in the 
name column. The leftmost value column will contain 
the absolute address at which the first character in the 
subprogram will be loaded. To the right of the left- 
most value column will be printed rel factor xxxxx, 
where xxxxx is the relocation factor actually used in 
relocating the subprogram. 

The linkage symbols used, and their corresponding 
absolute addresses, will be printed in the five sets of 
symbol and value columns in the right half of the 
memory map. 



Monitor Diagnostic Messages 

The following types of messages are typed on the 
console printer and/or printed on the Standard Print 
Unit: 

1. Diagnostic messages for programmers 

2. Messages for operators 

3. Initialization messages 

4. Bootstrap routine messages 

5. Messages during restart 



Diagnostic Messages for Programmers 

Diagnostic messages for programmers are written on 
the console printer, on the Standard Print Unit (spr), 
or both. The messages that may be issued, their ex- 
planations ( including an indication of where the mes- 
sages appear), and their corrective actions, if any, 
are listed below. 



UEPx 



Explanation: ( console printer ) Unusual end of program. 
Execution of program has been terminated or the Transi- 
tional Monitor has determined that the remainder of the 
job cannot be successfully executed. 

If x = 1: Dependent program requested a phase that 
could not be found. 

If x zz 2: Dependent program requested a phase to be 
loaded and executed. Phase was loaded, but has no 
entry point. 

If x = 3: Dependent program attempted input/output 
with a symbolic unit for which no physical unit was 
assigned. Or, a file table in the dependent program con- 
tains a SYMUNIT field with an address that does not 
correspond to any entry in the Resident Monitor's table 
of symbolic units. 

If x = 4: Dependent program attempted input/output 
with a symbolic unit which was assigned to a physical 
unit of a device type other than that requested by the 
dependent program. 
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If x = 5: Dependent program requested a phase that 
could not be loaded because of a permanent I/O error. 
If x = 9: A branch to the /UEP/ entry point of the 
End-of-Program routine was made from outside the 
Resident Monitor. When a dependent program branches 
to /UEP/, the message will contain the contents of the 
B-Address Register at the time of the branch. If the 
address is absent, i.e., UEP9 message, the Transitional 
Monitor entered the End-of-Program routine at the 
/UEP/ point and the status of core storage was not 
written on the Core Image file. 

NOTE: If x = 3 or 4, the message contains the address 
of the units position of file table field before the 
SYMUNIT field. 
Action: None by operator. 

00501 SOF DIRECTORY NOT FOUND 

Explanation: (Console printer and/or Standard Print 
Unit) Transitional Monitor is unable to find a directory 
for the System Operating File. 

Action: None by operator. ( System Operating File must 
be regenerated. ) 

00502 MJB DIRECTORY NOT FOUND 

Explanation: (Console printer and/or Standard Print 
Unit) Transitional Monitor is unable to find a directory 
for the disk Job file. The directory was inadvertently 
destroyed, an error was made in assignment, or the 
Linkage Loader is not functioning properly. 
Action: Reinitialization is necessary, if the batch is to 
be continued. The situation should first be analyzed to 
determine the exact cause of error. Regeneration of the 
System Operating File may be required. 

00503 INVALID DIRECTORY RECORD 

Explanation: ( Console printer and/or Standard Print 
Unit) Transitional Monitor has located what should be 
the directory for the disk System Operating File, but 
record read was not a valid directory record. 
Action: None by operator. (System Operating File must 
be regenerated. ) 

00504 SIU/AIU SWITCH FAILED 

Explanation: (Console printer) The switch to either the 
SIU or the AIU has failed. 

Action: Check assignment and device type for AIU and 
SIU. Rerun. 

10520 CGO-LL 

Explanation: (Console printer and/or Standard Print 

Unit ) A language processor has canceled the Go file and 

execution of the Linkage Loader is, therefore, being 

bypassed. 

Action: None by operator. 

10521 CGO-MJB 

Explanation: (Console printer and/or Standard Print 
Unit) The contents of the Job file are not valid; there- 
fore, the EXEQ card for a program on the Job file is 
being bypassed. 
Action: None by operator. 

10522 1ST [2ND, 3RD] OP INV 

Explanation: (Console printer and/or Standard Print 
Unit) An EXEQ card with an invalid operand has just 
been read and is being bypassed. 
Action: None by operator. 

10523 NO AIU 

Explanation: (Console printer and/or Standard Print 

Unit) An EXEQ card with a third operand has just been 

read but cannot be processed because facilities for using 

an Alternate Input Unit were not specified at System 

Generation. 

Action: None by operator. 



10524 AIU ACTIVE 

Explanation: (Console printer and/or Standard Print 
Unit) An EXEQ card with a third operand has just been 
read from the Alternate Input Unit and is, therefore, 
being bypassed. 
Action: None by operator. 

10525 CHG ttttt 

Explanation: (Console printer and Standard Print Unit) 
The symbolic unit in the third operand of the EXEQ 
card just read cannot be found in the Resident Monitor's 
assignment table. Therefore, the Transitional Monitor 
cannot effect a change to that unit. The EXEQ card is 
bypassed. 

ttttt = The address of the Transitional Monitor rou- 
tine that tried to effect the change. 
Action: None by operator. 

10526 CHG UNASGN 

Explanation: (Console printer and Standard Print Unit) 
The symbolic unit in the third operand of the EXEQ 
card just read is not currently assigned to a physical 
unit. The EXEQ card is bypassed. (This message pos- 
sibly could occur if parts of the Resident Monitor were 
destroyed, breaking the assignment for the Standard 
and/or Alternate Input Unit. ) 
Action: None by operator. 

10527 CHG INV 

Explanation: (Console printer and Standard Print Unit) 
The symbolic unit in the third operand of the EXEQ 
card just read is currently assigned to a disk physical 
unit, which is not permissible. The EXEQ card is by- 
passed. 
Action: None by operator. 

10529 GO DSK EXC 

Explanation: (Console printer) During compilation, the 
disk physical unit assigned to the Go file has been 
exceeded. The language processor has canceled the Go 
file and returned control to the System Monitor. 
Action: None by operator. 

10530 NOT FOUND 

Explanation: (Console printer and/or Standard Print 
Unit) 

Tape System Operating File: The program named in 
the EXEQ card cannot be found on the System Op- 
erating File (if SOF is specified on card) or on the Job 
file (if MJB is specified on card). The EXEQ card is 
bypassed. 

Disk System Operating File: The program named in 
the EXEQ card cannot be found in the directory speci- 
fied by the card. The EXEQ card is bypassed. 
Action: None by operator. (The System Operating File 
or Job file should be analyzed to determine the reason 
for the failure, in a tape system. The directory for the 
System Operating File or Job file should be analyzed to 
determine the reason for the failure, in a disk system.) 

10531 NOT FOUND IN SOF DIRECTORY 

Explanation: (Console printer and/or Standard Print 
Unit) The program named in the EXEQ card is not 
listed in the tape System Operating File directory. The 
EXEQ card is bypassed. 

Action: None by operator. (The tape System Operating 
File directory should be analyzed to determine the reason 
for the failure. ) 

10532 INCOMPATIBILITY IN BLOCK COUNTS 
Explanation: (Console printer and/or Standard Print 
Unit) Using block counts to search the System Operating 
File, the Transitional Monitor is unable to locate the de- 
sired program. One correction attempt will be made and, 
if not successful, the System Operating File will be re- 
wound and sequentially searched. 

Action: None by operator. 
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NOTE: The frequent appearance of this message indi- 
cates one or more of the following conditions: 

1. Block counts in directory are wrong. 

2. Block counts in phase headers are wrong. 

3. Backspace often fails on the tape unit. 
Correction of the trouble will improve search time for 
the System Operating File. 

10535 MJB INVALID LOC 

Explanation: (Console printer and/or Standard Print 
Unit) In searching the Job file, the Simple Search sub- 
routine has read one record from the file; this record is 
not a phase header record. The two possible causes are: 

1. The physical unit assigned to the Job file does not 
contain the Job file. 

2. The Job file tape has been moved to an incorrect 
position. 

Action: None by operator. The System Monitor will give 
control to the End-of-Program routine at the /UEP/ 
entry point. 

Messages for Operators 

All operator messages, their explanations, and their 
corrective actions, if any, are listed below. All such 
messages appear only on the console printer. 
ASGN OP INVALID xnn 

Explanation: ASGN card operand is invalid. System 
Monitor rejects assignment and enters End-of-Program 
routine at /UEP/ entry point. 

nn = Number of ASGN card operand that was 
invalid. 

x = ( blank ) : Either the symbolic unit or the physical 
unit could not be found in the Resident Monitor's assign- 
ment table. 

x = 4: Sequence rules for sharing physical units 
were violated. (For example, if "MW2,A1,A2" is a cur- 
rent assignment, then "MW5,A2,A3" cannot be made.) 

x = 8: Rules for sharing physical units were violated. 
(For example, the physical unit used by the Standard 
Input Unit cannot also be assigned to another symbolic 
unit. ) 

x = T: Attempt was made to assign a Tele-processing 
system file when the Tele-processing system was open. 
Action: None by operator unless this message is followed 
by (ASGN card image) INVALID ASSIGNMENT, in 
which case the procedure for that message should be 
followed. 
END AIU 

Explanation: END card or end of file has occurred on 
the Alternate Input Unit. 
Action: None by operator. 
END SIU 

Explanation: END card or end of file has occurred on 
the Standard Input Unit. 
Action: None by operator. 
ENTER B MESSAGES 

Explanation: Transitional Monitor is ready to accept 

class B messages from operator. 

Action: 

1. Press INQUIRY REQUEST. 

2. If the HALT option was specified for the Wait- 
Loop routine, press START. 

3. Enter message. (Class A messages are also accept- 
able at this time. ) 

4. Press INQUIRY RELEASE. 

NOTE: This procedure is repeated for each message. 
The last message must be $BX to cause normal process- 
ing to resume. 
INV A MSG 

Explanation: An invalid console inquiry was entered 
when only class A messages can be accepted. The mes- 
sage has been ignored and processing resumed. 



Action: Repeat the console inquiry if a valid class A 
message was intended. Otherwise, wait until 20501 
ENTER B MESSAGES appears on the console printer 
before repeating the console inquiry. 
INV B INQ 

Explanation: Invalid console inquiry has been made 
while Transitional Monitor is ready to accept class A or 
B messages. Monitor remains in waiting loop. 
Action: 

1. Press INQUIRY REQUEST. 

2. If the HALT option was specified for the Wait- 
Loop routine, press START. 

3. Enter valid message. ( If none, enter $BX. ) 

4. Press INQUIRY RELEASE. 

INV CHAN CHAR IN INIT 

Explanation: The channel character entered in the ini- 
tialization instruction is invalid. 

Action: Re-enter the initialization instruction, using a 
valid channel character. 
SWITCH TO NEXT SIU W/O INITIALIZATION 

Explanation: The System Monitor has begun reading the 
new Standard Input Unit batch in accordance with in- 
struction from the console. This message occurs when a 
new batch has been placed on the Standard Input Unit, 
and the waiting loop following the end of the previous 
Standard Input Unit has been broken by the $BX 
inquiry. ) 
Action: None by operator. 

10101 mms 

Explanation: This message indicates a I/O error. 
Action: See the Operator's Guide publication for correc- 
tive actions to be taken. To resume operation, turn the 
PRIORITY ON switch off and then on. 

10103 CPT nnx 

Explanation: Records have been written on the Core 
Image file, because an unusual end of program occurred 
or the current program took a checkpoint. 

nn = Number of such records since the last initializa- 
tion of the system. 

x = C: Checkpoint. 

x = D: Contents of core storage written on Core 
Image file following an unusual end of program. 
Action: None by operator. 

10104 REP INQ 

Explanation: Console inquiry was made while a previous 
inquiry was being processed; error occurred during a 
console read; or console inquiry was canceled. 
Action: Repeat console inquiry. 

10190 xx 

Explanation: This message indicates that the operator 
has tried to initialize SPOOL on a unit already process- 
ing SPOOL, xx is the assigned unit. 

Action: Re-enter $B7 message on another unit or enter 
a $B7R release message. 

10191 nnnnnnnnnn 

Explanation: This message indicates that the program is 
not on SOF. 

Action: Re-enter $B7 message with another program 
name or enter a $B7R release message. 

10192 SIP 

Explanation: This message indicates that an attempt has 
been made to initialize a SPOOL Supervisor which is 
already in process. 

Action: If the operator wishes to terminate the function 
in process he must: 

1. Press PRIORITY ON and enter a $B7R release 
message to cancel current assignment of that unit. 

2. Enter correct $B7 message. 
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10199 EOSn 

Explanation: This message indicates that the SPOOL 
function has been completed on channel n. 
Action: No action unless another file is to be processed. 
If another file is to be processed, turn the PRIORITY 
ON switch off and then on. 

20502 SUB FOR SS 

Explanation: An ASGN card has been read for a physi- 
cal unit that is currently unavailable. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter class C message: $Clss. 

3. Press INQUIRY RELEASE. 

NOTE: The $B6ss message cannot be used at this 
time to remove the unavailable indication from the unit 
named in the 20502 SUB FOR SS message. 

20503 INV AT END SITUATION 

Explanation: END card or end of file has been en- 
countered on the Alternate Input Unit, but a return to 
the Standard Input Unit cannot be effected. (Possible 
cause: contents of Standard Input Unit input area have 
been destroyed.) Transitional Monitor has entered a 
dead-end waiting loop. 

Action: Reinitialization is necessary if batch is to be 
continued. 
30101 cu 

Explanation: This message indicates that the header label 
fields of an input tape do not match the fields in the 
SPOOL control type. 

Action: See the Operator's Guide publication for actions 
to be taken. 

Initialization Messages 

Messages issued during initialization, along with their 
explanations and any associated corrective actions, 
are listed below. For details on initialization, see the 
Operators Guide publication. 
DATE NOT ENTERED 

Explanation: First JOB card has been read, but no 

DATE card has been processed. 

Action: 

1. Press INQUIRY REQUEST. 

2. Enter five-character date. 

3. Press INQUIRY RELEASE. 
ENTER ASGN FOR MDM 

Explanation: Initialization routine is ready to accept 

physical unit symbols for the MDM. 

Action: 

1. Press INQUIRY REQUEST. 

2. Enter two-position physical unit symbol for MDM. 

3. Press INQUIRY RELEASE. 
ENTER ASGN FOR MDM AND MDT 

Explanation: Initialization routine is ready to accept 
physical unit symbols for the MDM and MDT. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter two-position physical unit symbol for MDM 
and MDT respectively (e.g., A6B5). 

ENTER DATE, I/O ASSIGNMENTS, JOB NUMBERS 

Explanation: Initialization routine is ready to accept 
initialization information. (This message is given only 
during reinitialization without rewind. ) 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter five-character date. 

3. Press INQUIRY RELEASE. 

4. Wait for next message, which should be "IO 
OR JN". 



ENTER JOB NUMBERS 

Explanation: Initialization routine is ready to accept job 
numbers for the Standard or Alternate Input Unit. 
(This message is given only during reinitialization with 
rewind. ) 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter two-character job numbers ( Standard Input 
Unit first). If the Alternate Input Unit is not included 
in an installation or was not assigned when the need for 
reinitialization arose, enter two blank characters for the 
Alternate Input Unit job count. (A total of four charac- 
ters must be entered. ) 

3. Press INQUIRY RELEASE. 

INV INITIAL CHAR 

Explanation: Character at location 00000 is not a valid 

initialization status character. (That is, it is not A, B, 

C, orD.) 

Action: Start over with a valid initialization status 

character. 

IO OR JN 

Explanation: Initialization routine is ready to accept 
input/output assignments or job numbers. (This mes- 
sage is given only during reinitialization without re- 
wind. ) 

The first time this message appears during reinitial- 
ization, it indicates the date has just been processed. 
Each successive time the message appears, it indicates 
that the assignment just entered through the console 
printer has been processed; the Initialization routine is 
ready to accept the next assignment or, if all assign- 
ments have been given, the job numbers for the 
Standard and Alternate Input Units. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter a five-character assignment (symbolic unit 
name followed by assignment symbol) or, if all assign- 
ments have been entered, enter two-character job num- 
bers (Standard Input Unit first). If the Alternate Input 
Unit is not included in an installation or was not as- 
signed at the time the need for reinitialization arose, 
enter two blank characters for the Alternate Input Unit 
job number. 

3. Press INQUIRY RELEASE. 

NOTE: An INQUIRY REQUEST and INQUIRY 
RELEASE must precede and follow each five-character 
assignment entry and the four-character job numbers 
entry. 

IO OR JN RE ENTER xxx 

Explanation: This message is given to permit the opera- 
tor to correct an invalid assignment or to cancel the 
assignment by entering the job numbers for the Stand- 
ard and Alternate Input Units. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter five-character assignment or two two-char- 
acter job numbers. 

3. Press INQUIRY RELEASE. 

MUST ENTER SOF/SIU ASGN SYMB 

Explanation: System Operating File is on a unit differ- 
ent from the one specified at System Generation, but 
operator did not enter a word mark at location 00000 
to request a change of assignment. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter current assignments for both the System 
Operating File and Standard Input Unit. Enter the 
two-character assignment symbol for the System Operat- 
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ing File first, immediately followed by symbol for Stand- 
ard Input Unit. 

3. Press INQUIRY RELEASE. 
ENTER RST NUMBER 

Explanation: Initialization routine is ready to accept the 
number of the checkpoint that is to be used for the 
restart. 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter three-character checkpoint number. 

3. Press INQUIRY RELEASE. 
ENTER SOF/SIU ASGN SYMB 

Explanation: Initialization routine is ready to accept the 
assignment symbols for the System Operating File and 
the Standard Input Unit. (This message is given only 
when a word mark has been entered into location 
00000. ) 
Action: 

1. Press INQUIRY REQUEST. 

2. Enter assignment symbols for System Operating 
File and Standard Input Unit. Both must be entered 
even if only one assignment is being changed. System 
Operating File symbol must precede Standard Input 
Unit symbol. 

3. Press INQUIRY RELEASE. 
EOF SIU/AIU IN INIT 

Explanation: Initialization routine has encountered an 

end-of-file condition on the Standard or Alternate Input 

Unit. 

Action: Start over with the proper input on the unit. 

INIT ASGN EXCEED TABLE 

Explanation: Initialization routine for disk-oriented 
system has been given more initial assignments than can 
be stored in the table it is building for reinitialization. 
(Because the table will accommodate up to 150 assign- 
ments, this message is not normally expected.) 
Action: Start over with fewer ASGN cards preceding 
the first JOB card. 

(ASGN card image) INVALID ASSIGNMENT 

Explanation: Initialization routine has read an ASGN 
card that cannot be processed. (The ASGN card could 
be constructed internally from an assignment entered 
through the console printer. ) 

1. Press INQUIRY REQUEST. 

2. Enter a five-character assignment (e.g., MDMA1). 

3. Press INQUIRY RELEASE. 

SHARE VIOLATION, MONITOR COMPILATION 

Explanation: At System Generation, the rules concern- 
ing the assignment of System files were violated. This 
violation is detected during the first initialization of the 
System Operating File containing the invalid assign- 
ments. 

Action: None. (A new System Operating File must be 
generated to correct the invalid assignment s).) 

JOB SEARCH OUT OF STEP 

Explanation: Something has caused the Initialization 
routine to search past the job count entered. (This 
message is given only during reinitialization with re- 
wind. ) 
Action: Begin reinitialization again. 

Bootstrap Routine Messages 

All error messages, and their explanations, issued by 
the Bootstrap Routine are listed below. All messages 
appear only on the console printer; the corrective 
action for each message is to begin the bootstrap op- 
eration again. 



BOOTSTRAP ERROR 01 

Explanation: Bootstrap routine, in a tape system, has 
found a header record, rather than an execute record, 
after the Resident Monitor record on the System Op- 
erating File. The Bootstrap routine has entered a waiting 
loop. 

BOOTSTRAP ERROR 02 

Explanation: Tape read error, other than wrong-length 
record, persists after re-reading nine times. The Boot- 
strap routine has entered a waiting loop. 

BOOTSTRAP ERROR 03 

Explanation: A tape read error occurred while the 
Bootstrap routine was trying to read a header record. 
The Bootstrap routine has entered a waiting loop. 

BOOTSTRAP ERROR 04 

Explanation: The first record after the Bootstrap rou- 
tine is not a header record. The Bootstrap routine has 
entered a waiting loop. 

BOOTSTRAP ERROR 05 

Explanation: The instruction loaded by the Bootstrap 
routine into location 00000 is not valid because it does 
not contain a non-overlap character in location 00002. 
The Bootstrap routine has entered a waiting loop. 

BOOTSTRAP ERROR 06 

Explanation: Disk read error persists after re-reading 
five times. The Bootstrap routine has entered a waiting 
loop. 

BOOTSTRAP ERROR 07 

Explanation: The Bootstrap routine has found an un- 
identifiable record while loading the Resident Monitor. 
The Boostrap routine has entered a waiting loop. 

00222 

Explanation: I-address of a halt. A tape read error, other 
than wrong-length record, occurred while the Bootstrap 
2 routine was being read. The computer has halted. 

00438 

Explanation: I-address of a halt. The instruction loaded 
by the Bootstrap routine into location 00000 is not valid 
because it does not contain a valid non-overlap character 
in location 00002. The computer has halted. 

Messages During Restart 

Messages, and their explanations, issued during Re- 
start operations are listed below. All messages appear 
only on the console printer; no operator action is re- 
quired for any message. 

10128 SPU-SPR SAME UNIT 

Explanation: Because the Standard Punch Unit and 
Standard Print Unit share the same tape unit, the Re- 
start program will make no attempt to reposition this 
unit during restart. 

10133 SIU U/R 

Explanation: Because the Standard Input Unit is a card 
reader, no attempt will be made by the Restart program 
to reposition the Standard Input Unit during restart. 

10134 AIU U/R 

Explanation: Because the Alternate Input Unit is a card 
reader, no attempt will be made by the Restart program 
to reposition the Alternate Input Unit during restart. 



Linkage Loader Diagnostic Messages 

The following is a list of diagnostic messages, and 
their explanations, issued by the Linkage Loader. 
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All messages appear only on the Standard Print Unit. 
Wherever a control card is printed, this fact is indi- 
cated following the messages. There is no operator 
action associated with any message; corrective action, 
if any, taken by programmers must be based on an 
analysis of the message explanation. 

SOF LIBRARY NAME UNEQUAL TO EXEQ CARD 

Explanation: The name of the relocatable library speci- 
fied in the fourth operand of the EXEQ LINKLOAD 
card cannot be found on the System Operating File. 
The Linkage Loader will end execution with a special 
end of program. 

/LIB/ HEADER NAME UNEQUAL TO EXEQ CARD 

Explanation: The physical unit assigned to LIB does not 
contain the library named in the fourth operand of the 
EXEQ LINKLOAD card. The Linkage Loader will end 
execution with a special end of program. 

INPUT CARD INVALID 

Explanation: The operand of the INPUT card cannot be 
identified by the Linkage Loader. The Linkage Loader 
will end execution with a special end of program. 

***** BAD INPUT CARD (contents of card) 

Explanation: The card type in column 72 or the card 
name in column 16 is in error. (The input card can be 
any card, not just the INPUT control card.) The Link- 
age Loader will end execution with a special end of 
program. 

***** BAD INDICATOR (contents of card) 

Explanation: One of the relocation indicators on the 
card is in error. The Linkage? Loader will end execution 
with a special end of program. 

***** CORE EXCEEDED (contents of card) 

Explanation: The relocated load address plus the size of 
the common data area is greater than the machine's 
highest addressable location. If the SG mode is ON, 
this is a warning message; Linkage Loader processing is 
continued. If the SG mode is OFF, the Linkage Loader 
will end execution with a special end of program. 

***** SYMBOL UNDEFINED (contents of card) 

Explanation: The symbol in the operand (for a control 
card) or used as the load address (for a load card) has 
not been defined. This is a warning message. Linkage 
Loader processing is continued. 

***** TABLE OVERFLOW 

Explanation: The Linkage Loader symbol table has 
been exceeded. The Linkage Loader will end execution 
with a special end of program. The user should reorder 
the program deck so that the number of forward ref- 
erences of linkage symbols is reduced. 

***** SNAP IGNORED (contents of SNAP card) 

Explanation: This message indicates that the subpro- 
gram named in the SNAP card has not been processed. 
The message can also indicate that columns 56 and 57 
of the SNAP card were blank. The Linkage Loader 
ignores the Snapshot request and continues processing. 

***** BAD LOAD ADDR (contents of card) 

Explanation: After relocation, the load address in the 
printed card is in the Resident Monitor area. The Link- 
age Loader will end execution with a special end of 
program. 

***** JOB FILE NOT CREATED 

Explanation: This message indicates that ( 1 ) the Link- 
age Loader put no output on the job file, ( 2 ) the Link- 



age Loader read other subprogram cards before reading 
a PHASE or TITLE card, or (3) the first PHASE card 
read did not contain an operand. The Linkage Loader 
will end execution with a special end of program. 

***** UNRESOLVED ENTRIES NONE 

Explanation: All linkage symbols and calls were re- 
solved. The Linkage Loader continues processing. 

***** UNRESOLVED ENTRIES (list of unresolved linkage 
symbols and calls) 

Explanation: All linkage symbols and calls were re- 
solved except the ones listed. The format of the list of 
entries is* 

xxxxxLINKSYMBOL 
or 

xxxxxLINKSYMBOL 
where : 
xxxxx is location where definition of symbol or call was 

needed 
LINKSYMBOL is linkage symbol that was undefined 
The plus zone over the low-order position of xxxxx 
indicates that the entry was an imbedded call. If xxxxx 
contains blanks, the subprogram call was made in a 
Linkage Loader control card. 
The Linkage Loader continues processing. 

***** DUPLDEFIN (contents of second DEFIN card) 

Explanation: A second DEFIN card has been read for a 
linkage symbol in a program. The Linkage Loader con- 
tinues processing and ignores the second DEFIN card. 

***** FIRST LIB REC NOT DIR 

Explanation: The first record of a relocatable library on 
disk was not a directory. A common cause of this error 
is the loading of the library onto the wrong area on the 
disk. The Linkage Loader will end execution with a 
special end of program. 

***** ERROR (contents of card) 

Explanation: This message indicates an error in specifi- 
cation of a chained program. The Linkage Loader will 
end execution with a special end of program. 

*****END OF FILE INDICATOR WHILE ATTEMPTING 
TO PROCESS LIBRARY 

Explanation: The area assigned to /LIB/ does not con- 
tain enough tracks. A module which is being processed 
resides outside this area. The area assigned to /LIB/ 
must be increased to contain the entire library. The 
Linkage Loader will end executions with a special end 
of program. 



Console Inquiries 

Console inquiries are used to communicate control in- 
formation to various portions of the System Monitor. 
The messages that can be entered through the console 
are divided into three classes, as follows: 

A. Messages that can be accepted by the Resident 
Monitor during the execution of a dependent program. 

B. Messages that can be accepted by the Transi- 
tional Monitor between jobs. 

C. Messages that are communicated to the Transi- 
tional Monitor in reply to a request from the Transi- 
tional Monitor for specific control information. 

The messages are communicated to the System 
Monitor by: 
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1. Depressing the inquiry request key. 

2. Typing in the message. 

3. Depressing the inquiry release key. 

Class A Messages 

The following messages can be accepted during execu- 
tion of a dependent program. Unless otherwise stated, 
the entire message consists of the three characters 
listed. 



$10 



Entry Time: Any time during execution of a dependent 
program. 

Explanation: This message causes immediate entry to 
the /UEP/ point of the Resident Monitor's End-of- 
Program routine. This message cannot be used for pro- 
grams under control of the Tele-processing Supervisor. 
NOTE: The operator can also branch to the /UEP/ 
entry by pressing the COMPUTER RESET key and 
then START key. However, this procedure resets cer- 
tain machine indicators. Therefore, records on the Core 
Image file may not reflect the status of storage at the 
time the dependent program failed. (The RESET and 
START key procedure should not be used in a Tele- 
processing system. ) 



$20 



Entry Time: Any time during execution of a dependent 

program 

Explanation: This message requests the Transitional 

Monitor to notify the operator when it can accept class 

B messages. Notification is given after the next JOB 

card or EXEQ card. 

$3x ( any input wanted ) 

Entry Time: In answer to user-specified message or any 
time during execution of a dependent program. 
Explanation: This message causes the Resident Monitor 
to place x in /MCI/. The entire message is put in the 
input area whose high-order position is designated by 
/RIQ/. This message is used to provide console input 
to the dependent program. 



$50 



$70 



Entry Time: Normally after a user-specified message. 
For FORTRAN, the user message is PAUSE nnnnn, 
where nnnnn is a five-digit number. 

Explanation: This message causes the Resident Monitor 
to exit from its Wait-Loop routine and return control to 
the dependent program. 

NOTE: If the HALT option was specified for the Wait- 
Loop routine, before entering the $50 message, the 
operator must: 

1. Press INQUIRY REQUEST. 

2. Press START. 

The operator must press INQUIRY RELEASE after 
entering the $50 message. 

Entry Time: Any time during execution of a program 
that is requesting checkpoints and can be restarted. 
Explanation: This message signals the Resident Mon- 
itor to initiate immediate restart procedures. (See the 
Operator's Guide publication. ) 

Entry Time: In reply to a 20101, 30101, or 30102 mes- 
sage from the Resident IOCS. 

Explanation: This message, which has three forms ( x = 
A, R, or C), is described in the Operator's Guide publi- 
cation. 



$90b (any input of up to 16 characters) 
Entry Time: Any time. 

Explanation: This message is used to communicate in- 
formation to the Tele-processing system. (See the Tele- 
processing Supervisor publication. ) 

Class B Messages 

The following messages can be accepted by the Tran- 
sitional Monitor. When class B messages can be ac- 
cepted, the Transitional Monitor notifies the operator 
by the console message: enter r messages. Class A 
messages can also be accepted at this time. This 
message is written if the operator previously entered 
the $20 inquiry, and each time an end card is read 
from the Standard Input Unit or Alternate Input Unit. 
The Transitional Monitor enters a waiting loop or, if 
the halt option was specified, halts after writing this 
message. 

Unless otherwise stated, each of the following mes- 
sages consists entirely of the characters listed. 

$B1 

Explanation: This message causes the Resident Moni- 
tor's Read routine to be altered to read from the Alter- 
nate Input Unit. This message cannot be entered if the 
console message ENTER B MESSAGE follows an END 
SIU message. 

$B2 

Explanation: This message causes the Transitional Moni- 
tor to close, rewind, and unload the Standard Print Unit 
tape. After the tape is unloaded, the operator mounts 
another tape on the unit. 

$B3 

Explanation: This message causes the Transitional Moni- 
tor to close, rewind, and unload the Standard Punch 
Unit tape. After the tape is unloaded, the operator 
mounts another tape on the unit. 

NOTE : This message is used only if the Standard Punch 
Unit is not assigned to the same tape as the Standard 
Print Unit. If both units use the same tape, then the 
$B2 message is used for the closing function. 

$B4 

Explanation: This message causes the Transitional Mon- 
itor to close, rewind, and unload the Core Image file 
tape. After the tape is unloaded, the operator mounts 
another tape on the unit. 

$B5ss 

Explanation: This message indicates to the Transitional 
Monitor that the physical unit represented by assign- 
ment symbol ss is currently unavailable for use. 

$B6ss 

Explanation: This message indicates to the Transitional 
Monitor that the physical unit represented by assign- 
ment symbol ss is now available for use. The Transi- 
tional Monitor removes the unavailable indication it 
had set in response to a $B5ss message for this physical 
unit. 

$B7bxxyyb 

Explanation: This message assigns physical units xx and 
yy as SPOOL units and indicates that no editing rou- 
tine is to be loaded. Only TYPE I SPOOL will be per- 
formed as a result of this message, regardless of the 
SPOOL type placed in the Resident Monitor. This is a 
valid message for any of the SPOOL control types. Odd 
tape parity is assumed. 
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I $B7bxxyynnnnnnnnnnb 

Explanation: This message assigns physical units xx and 
yy as SPOOL units and causes loading of the editing 
routine. The editing routine name, NNNNNNNNNN, 
need not be ten characters, but a blank must be entered 
after the last character of the name. This message is 
valid only for TYPE II and TYPE III SPOOL. Odd 
tape parity is assumed. 

I $B7Bxxyynnnnnnnnnnb 

Explanation: Same as above, specifying odd tape parity. 

| $B7Uxxyynnnnnnnnnnb 

Explanation: Same as above, specifying even tape parity. 

$B7Rxxyy 

Explanation: This message releases physical units xx 
and yy from their SPOOL assignments. This message is 
valid for all SPOOL control types. 

$BX 

Explanation: This message indicates that the operator 
has no more class B messages at this time. It causes the 
Transitional Monitor to exit from the waiting loop it 
had entered to allow console inquiries. This message 
must be given to enable the Transitional Monitor to 
resume processing. 

After the $BX message is entered, the Transitional 
Monitor completes functions related to previous class 
B messages. For example, the complete procedure for 
use of a $B2 message is: 

1. The Transitional Monitor types out enter b 
messages to notify the operator it is ready to accept 
class B messages and then enters a waiting loop or 
halts. 

2. If the machine is in a waiting loop, the operator 
presses inquiry request and enters the $B2 message. 
If a machine halt has occurred, the operator presses 
inquiry request, presses start, and then enters the 
$B2 message. After the message is entered, the oper- 
ator presses inquiry release. 

3. The Transitional Monitor performs the closing 



functions for the Standard Print Unit and returns to 
the waiting loop or halts. 

4. The operator mounts another tape for the Stand- 
ard Print Unit. If the machine is in a waiting loop, the 
operator presses inquiry request and then enters the 
$BX message. If a machine halt has occurred, the 
operator presses inquiry request, presses start, and 
then enters the $BX message. After the message is 
entered, the operator presses inquiry release. 

5. The Transitional Monitor opens the file for the 
new tape and resumes other processing related to 
preparation for the next job. 

When the $BX message is entered in answer to 
an enter b messages following an end siu message, 
the Transitional Monitor resumes reading and proc- 
essing from the Standard Input Unit and without ini- 
tialization. Therefore, it will ignore any daily infor- 
mation, such as a date card, and will skip to the next 
job card. 

Class C Messages 

The following message is given in reply to a message 
from the Transitional Monitor. 

Monitor Message Received 

20502 SUB FOR SS 

Explanation: This message indicates that an ASGN card 
specified an assignment symbol, SS, for a physical unit 
that is not available. 



$Clss 



Explanation: This message specifies that the assignment 
symbol ss is to be substituted for the one contained in 
the ASGN card. The substituted physical unit must be 
currently available. 

NOTE: The $B6ss message cannot be used at this time 
to indicate that the unit specified on the ASGN card is 
now available; it must have been entered before the 
ASGN card was read. 
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Program Patching 



Relocatable subprograms on the System Library file or 
Go file can be corrected or changed by placing patch 
cards in the Standard or Alternate Input Unit after a 
callp card. The patching is performed by the Linkage 
Loader immediately after it processes the called sub- 
program. 

Considerations for patching are: 

1. Calls imbedded in a subprogram by dcws, dcwf, 
and call statements cannot be negated through 
patching. 

2. The functions of defin, basei, base2, and prtct 
cannot be overridden through patching. 

3. An instruction that contains a linkage symbol for 
an address can be patched only if the symbol in the 
original instruction has been resolved before the patch 
is processed. 

Patch cards must be punched in the formats for re- 
locatable object cards as described below. 

All cards in a subprogram must have a card type 
punched in column 72. The card types are summarized 
in Figure 12. 



Number in 
Column 72 


Card Type 





Load card with absolute location or linkage 
symbol as load address 


1 


Load card with upward relocation factor to be 
applied to load address 


2 


Load card with downward relocation factor to be 
applied to load address 


3 


Termination card for primary subprogram 


4 


DEFIN, BASEI, BASE2, PRTCT, ENTRY, or CALL card 


5 


TITLE card 


8 


Set word mark or record mark card 


9 


Termination card for secondary subprogram 


W 


Clear word mark card 


Y 


Clear storage between limits card 


Z 


Random load card 


blank 


LINK,COMN, or END card for chained program 



Figure 12. Card-Type Summary 

Column 71 and down of certain cards contain re- 
location indicators, which give to the Linkage Loader 



relocation information and characteristics of instruc- 
tions and data in the card. The relocation indicators 
are summarized in Figure 13. 

Note 1: Constants and instructions may not be on 
the same card. 

Note 2: A linkage symbol, when used as an address, 
must indicate no relocation for that section of the 
instruction. 



Relocatable Object Cards 



TITLE Card 

The format for the title card is: 



Column 

16-20 

21-30 

31-35 



41-45 



72 



Contents 
TITLE 

( 1- to 10-character subprogram name, left-justified, 
with trailing blanks ) 

( Origin point to which subprogram was compiled. 
Usually 00000 or blanks for Autocoder programs; 
00001 for FORTRAN programs; the size of 
IBCOBOL for COBOL programs. ) 
(Total number of core-storage locations required 
by an Autocoder subprogram for a common data 
area. ) 
5 



Note: title cards as generated by a language proc- 
essor may contain additional data, not used by the 
Linkage Loader, in columns 6-10 and 73-80. For a 
complete description of the title card generated by a 
given compiler, refer to the applicable processor lan- 
guage manual. 

Termination Card (for Subprograms) 

The format for the subprogram Termination card is : 

Column Contents 

1 E 

2 Word separator character ( 0-5-8 punch ) 

3-7 (Entry point for primary subprogram, blanks for 

secondary subprogram ) 
72 3 (for primary subprogram) or 9 (for secondary 

subprogram ) 

The entry point address in columns 3 through 7 is 
the compiled address. It will be relocated by the Link- 
age Loader using the upward relocation factor for the 
subprogram. 

Load Card 

The format for the load card is: 

Column Contents 

1 Word separator character ( 0-5-8 punch ) 

2-6 (Load address: Low-core address of the area into 

which the characters in columns 13 and up are 

to be loaded ) 
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Column Contents 



7 

8-10 

11-12 

13-up 



Word separator character (0-5-8 punch) 

Zeros 

( Length in core storage. Number of characters to 

be loaded from this card. ) 



(Instructions or constants to be loaded into storage, 
left-justified ) 

NOTE 1 : To load a word mark into storage, punch 
a word separator character in the column preceding 
the character with which the word mark is to be 
associated. These word separator characters are 
not included in the count columns 11 and 12. To 
enter a word separator character into storage, 
punch word separator characters in two adajacent 
columns. Add only "1" to the count. 
NOTE 2: Instructions, DCWS calls, and DCWF 
calls may appear on the same card, but cannot ap- 
pear on a card containing constants. 

71 -down (Relocation indicators. The indicator punched in 
column 71 applies to the first instruction or con- 
stant in the card, the indicator in column 70 ap- 
plies to the second instruction or constant, etc. 
Relocation indicators are given in Figure 13. 

72 (for load card with absolute location or ABCD/ 

linkage symbol as load address. If the load ad- 
dress is a linkage symbol, the symbol must have 
been defined before the Linkage Loader reads 
this card. ) 

1 (for load card with upward relocation factor to 
be applied to numeric load address. ) 

2 (for load card with downward relocation factor 
to be applied to numeric load address. ) 

dcws and dcwf calls may be included in the instruc- 
tions in columns 13 and up. To include these calls, 



punch a word separator character followed by the 1- 
to 10-character subprogram name, left-justified, with 
trailing blanks in a 10-position field. The factor to be 
added into the count in columns 11 and 12 is seven for 
a dcws and five for a dcwf. 

Linkage symbols appearing as an address are given 
a no relocation indicator. 

Note: There must be at least one blank between 
the instructions and the relocation indicators on the 
load card. 

DEFIN Card 

The format for the defin card is: 

Column Contents 



6-15 

16-20 
21-30 



71 



72 



(5-character or 1- to 10-character linkage symbol, 
left-justified, with trailing blanks) 
DEFIN 

(5-character numeric address or 1- to 10-character 
linkage symbol, left-justified, with trailing blanks. 
For a numeric address, index register tags in the 
tens and hundreds positions are permissible. If 
a linkage symbol is used, its value must have been 
defined before the Linkage Loader reads this card. ) 
Blank ( Relocate upward ) 
P ( Relocate downward ) 
Q ( no relocation ) 

NOTE: These relocation indicators are for the ad- 
dress in columns 21 through 30. The Q relocation 
indicator is required if a linkage symbol is used 
in columns 21 through 30. 
4 





Without d-Modifier 


With d-Modifier 




Card Code 


Length in 




Card Code 


Length in 




Relocation 


for 


Core 


Relocation 


for 


Core 


Description of Relocation 


Indicator 


Indicator 


Storage 


Indicator 


Indicator 


Storage 


No address 


9 


9 


1 


1 


12-9 


2 


X-control operation, B-address upward 


J 


11-1 


10 








X-control operation, B-address downward 


K 


11-2 


10 








X-control operation, no relocation for B-address 


L 


11-3 


10 








X-control operation, no B-address 


M 


11-4 


5 








Single address, upward 


@ 


4-8 


6 


□ 


12-4-8 


7 


Single address, downward 




5-8 


6 


c 


1 2-5-8 


7 


Single address, no relocation 


> 


6-8 


6 


< 


1 2-6-8 


7 


Two addresses, no relocation 










? 


12-0 


12 


Two addresses, only B-address upward, no relocation 


1 


1 




A 


12-1 


12 


for A-address 














Two addresses, only B-address downward, no relocation 


2 


2 




B 


12-2 


12 


for A-address 














Two addresses, only A-address upward, no relocation for 


3 


3 




C 


12-3 


12 


B-address 














Two addresses, both upward 


4 


4 




D 


12-4 


12 


Two addresses, A-address upward, B-address downward 


5 


5 




E 


12-5 


12 


Two addresses, only A-address downward, no reloca- 


6 


6 




F 


12-6 


12 


tion for B-address 














Two addresses, A-address downward, B-address upward 


7 


7 




G 


12-7 


12 


Two addresses, both downward 


8 


8 




H 


12-8 


12 


Address constant, upward 


N 


11-5 


5 








Address constant, downward 


P 


11-7 


5 








DCWS 


S 


0-2 


7 








Address constant, no relocation 


Q 


11-8 


5 








Constant 


blank 


none 










DCWF 


T 


0-3 


5 









Figure 13. Relocation Indicators 
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BASE1 Card 

The format for the basei card is: 

Column Contents 

16-20 BASEI 

21-30 (Left-justified linkage symbol, absolute address, 

* + X00, or blank) 
72 4 

If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 

BASE2 Card 

The format for the base2 card is: 

Column Contents 

16-20 BASE2 

21-30 (Left-justified linkage symbol, absolute address, 



72 



or blank) 
4 



If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 

PRTCT Card 

The format for the prtct card is: 

Column Contents 
16-20 PRTCT 

21-30 (Left-justified linkage symbol, absolute address, 

or blank ) 

72 4 

If a linkage symbol is used, it must have been de- 
fined before the Linkage Loader reads this card. 

ENTRY Card 

The format for the entry card is: 



Column 

16-20 

21-30 



72 



Contents 
ENTRY 

(1- to 10-character linkage symbol, including sub- 
program name, left-justified, with trailing blanks, 
or an absolute address ) 
4 



LINK Card 

The format for the link card is: 

Column Contents 

16-19 LINK 

21- (1- to 10-character linkage symbol followed by a 

comma, which may or may not be followed by a 
1- to 10-character linkage symbol or an absolute 
address ) 

COMN Card 

The format for the comn card is : 

Column Contents 
16-19 COMN 

21- ( 1- to 10-character linkage symbols separated by 

- one or two commas ) 

END Card for Chained Programs 

The format for the end card for chained programs is: 

Column Contents 
16-18 END 



CALL Card 

The format for the call card is: 

Column Contents 

CALL 

(1- to 10-character subprogram name, left- justi- 
fied, with trailing blanks ) 
4 



16-19 
21-30 
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Random Load Card 

The format of the Random Load card is: 

Column Contents 

1 Word separator character ( 0-5-8 punch ) 

2-6 (Load address: low-order address of area into 

which the characters in columns 7 through 11 are 
to be loaded ) 

7-11 (Five characters to be loaded in Move mode, be- 

ginning at the location specified in columns 2 
through 6. These five characters are considered 
to be an address and will thus be relocated. Load- 
ing the five characters will not affect any word 
marks set by previous load cards. ) 

12-22 (Same as columns 1 through 11) 

23-33 (Same as columns 1 through 11) 

34-44 (Same as columns 1 through 11) 

45-55 (Same as columns 1 through 11) 

67 ( Relocation indicator for columns 45 through 55 ) 

68 ( Relocation indicator for columns 34 through 44 ) 

69 ( Relocation indicator for columns 23 through 33 ) 

70 ( Relocation indicator for columns 12 through 22 ) 

71 (Relocation indicator for columns 1 through 11) 

72 Z 

The relocation indicators to be used in columns 67 
through 71 are: 



FIVE CHARACTERS 
TO BE LOADED 

No relocation 
Relocate upward 
Relocate downward 
No relocation 
Relocate upward 
Relocate downward 
No relocation 
Relocate upward 
Relocate downward 



RELOCATION LOAD 

INDICATOR ADDRESS 

No relocation 

1 No relocation 

2 No relocation 

3 Relocate upward 

4 Relocate upward 

5 Relocate upward 

6 Relocate downward 

7 Relocate downward 

8 Relocate downward 

These relocation indicators are also given in Figure 13. 

If word marks are wanted over the five characters to 
be loaded, they must be set before the Random Load 
card is loaded into storage for program execution. 

If less than five fields are needed, the relocation in- 
dicator corresponding to the first unused field must be 
left blank. 

The load address and/or the five characters to be 
loaded may be an abcd/ format linkage symbol. The 
corresponding relocation indicator must specify no 
relocation. 

Clear Storage Card 

The format for the Clear Storage card is: 



Column 

1 

2-6 

7 



Contents 



Word separator character ( 0-5-8 punch ) 
( Lowest address of area to be cleared ) 
Word separator character ( 0-5-8 punch ) 
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Column Contents 



8-12 
71 



72 



( Highest address of area to be cleared ) 
N ( Relocation indicator when the addresses in col- 
umns 2 through 6 and 8 through 12 are to be re- 
located upward) 

P (Relocation indicator when the addresses are to 
be relocated downward ) 
Y 



Set Word Mark or Record Mark Card 

The format for the Set Word Mark or Record Mark 
card is: 

Column Contents 

1 

2-6 



7 
8-12 



13 

14-18 

20 



Word separator character ( 0-5-8 punch ) 
(Address of first word mark or record mark to be 
set) 

Word separator character ( 0-5-8 punch ) 
(Increment factor, in storage locations, used to 
determine the location of the second, and succeed- 
ing, word marks or record marks to be set ) 
Word separator character ( 0-5-8 punch ) 
( Number of word marks or record marks to be set ) 
Record Mark (0-2-8 punch). (If this card is to 
set record marks. ) 
Blank ( If this card is to set word marks. ) 



Column 
71 



72 



Contents 

N (Relocation indicator, when the address in col- 
umns 2 through 6 is to be relocated upward) 
P (Relocation indicator, when the address in col- 
umns 2 through 6 is to be relocated downward) 



Clear Word Mark Card 

The format for the Clear Word Mark card is: 

Column Contents 



1 

2-6 

7 

8-12 



13 

14-18 

71 



72 



Word separator character ( 0-5-8 punch ) 
( Address of first word mark to be cleared ) 
Word separator character ( 0-5-8 punch ) 
(Increment factor, in storage locations, used to de- 
termine the location of the second, and succeeding, 
word marks to be cleared) 
Word separator character ( 0-5-8 punch ) 
( Number of word marks to be cleared ) 
N (Relocation indicator when the address in col- 
umns 2 through 6 is to be relocated upward) 
P (Relocation indicator when the address in col- 
umns 2 through 6 is to be relocated downward ) 
W 
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Operation of the System Monitor 



Operation of the System Monitor is divided into two 
categories: 

1. Initialization to prepare the Resident Monitor for 
work. 

2. Functioning of the System Monitor to control the 
Operating System. 

The System Monitor also enables restarting depend- 
ent programs from checkpoints. 



Initialization of the System Monitor 

Initialization of the System Monitor begins with bring- 
ing the Resident and Transitional Monitors into core 
storage from the System Operating File. They are 
brought into storage by the Bootstrap routine, which is 
the first element on the System Operating File. The 
Bootstrap routine is also used if reinitialization of the 
System Monitor becomes necessary because of an 
emergency. ( For example, a dependent program might 
fail in such a way that portions of the Resident Moni- 
tor are destroyed. ) 

The Initialization routine is brought into storage 
with the Resident Monitor. It is given control to per- 
form the housekeeping needed to prepare the Resident 
Monitor. For this housekeeping, the installation sup- 
plies the Resident Monitor with daily information con- 
trol cards. These cards are the Monitor date card and 
asgn cards for certain files used by the System Monitor. 

Reinitialization procedures include facilities for re- 
positioning the Standard or Alternate Input Unit, if 
tape, to the next job specified by the operator. 

For full details on initialization and reinitialization, 
see the Operator's Guide publication. 



Functioning of the System Monitor 

Example 1 

To illustrate functioning of the System Monitor, as- 
sume that a program is to be compiled, relocated, and 
executed. Control cards for such a program are shown 
in Figure 14. These cards are in a card reader Standard 
Input Unit. 

Both the Resident Monitor and Transitional Monitor 
are left in storage by initialization. During initializa- 
tion, the Transitional Monitor had just read and proc- 



essed the daily information cards on the Standard In- 
put Unit. When the Transitional Monitor reads the 
first job card, Monitor functioning begins. 

Following the job example card are comt, asgn, and 
mode cards. Note that for the language processors the 
mode go card is placed before the exeq cards. The 
Transitional Monitor processes these cards, then reads 
the first exeq autocoder card. It locates the Autocoder 
language processor on the System Operating File and 
branches to the Resident Monitor's Load routine with 
a request to load the Autocoder processor. A Clear 
Storage routine from the System Operating File is 
loaded immediately above the end of the Resident 
Monitor. The Clear Storage routine clears all of storage 
above the Resident Monitor, thus destroying the Tran- 
sitional Monitor, except for the first 99 positions above 
the Resident Monitor and the last two positions at the 
top of core storage. After storage is cleared, the Load 
routine brings in the Autocoder processor. 

The Autocoder processor reads its source statements 
from the Standard Input Unit. It uses three Work files, 
assigned by the daily information, as temporary stor- 
age during the compilation. The processor places its 
output (relocatable card-image records) on the Go 
file, because mode go was specified, and also punches 
out a relocatable object deck on the Standard Punch 
Unit. Use of the tape Go file eliminates the operator 
intervention that would have been required with only 
punched output. 

When the Autocoder processor is finished, it gives 
control to the Resident Monitor's End-of-Program 
routine at the /eop/ entry point. The Resident Monitor 
brings in the Transitional Monitor. The Transitional 
Monitor resumes reading the Standard Input Unit. 
The next card is the second exeq autocoder card. For 
this card, the System Monitor repeats the procedure 
performed for the first exeq autocoder card. 

The Autocoder processor must be executed twice, 
because the source statements for the two subpro- 
grams are on different files. 

In its second execution, the Autocoder processor 
places its output on the Go file after the output for 
subprogram A. 

When the Autocoder processor is finished, it returns 
control to the Resident Monitor, which brings in the 
Transitional Monitor. The Transitional Monitor reads 
the Standard Input Unit, assigning the Job file (mjb) 
to physical unit B2. 
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£ 



Etc. 

MON$$ JOB ANYNAME 



(Utility Programs Control Cards 



& 



MON$$ EXEQ UTILITIES 



Input Data for Program XYZ) 



^ 



MON$$ EXEQ XYZ,MJB \ / 



MON$'$ MODE TEST 



(Relocatable Object Deck for Subprogram D) 



TITLE D 



CALL B 



CALL A 



PHASE XYZ 



MON$$ EXEQ LINKLOAD, ; >YLIB 



MON$$ ASGN MJB,B2 



NOTE; Subprogram B Source Statements are on Tape MR1 
MON$$ EXEQ AUTOCODER,\MR1 



/(Subprogram A Source Statements) 



TITLE A 



MON$$ EXEQ AUTOCODER 
MON$$ MODE G5 \ 



MON$$ ASGN MGO,A2 



MON$$ ASGNMR1,A1 



MON$$ COMT ANY MESSAGE 



MON$$ JOB EXAMPLE 



Any Preceding Jobs 
Daily Information 

Figure 14. Control Card Deck for First Example 



Then the Transitional Monitor, for the exeq link- 
load card, repeats the procedure performed for the 
language processor's exeq cards to bring the Linkage 
Loader into storage. 

In this example, the Linkage Loader reads the call 
cards for subprograms A and B and puts the calls on 
the request list. Then it reads and processes subpro- 
gram D. The Linkage Loader continues reading and 
finds a Monitor control card. The Monitor control card 
forces the Linkage Loader to read in and process all 
subprograms on the request list. Thus, the Linkage 
Loader calls in and processes the newly compiled sub- 
programs A and B from the Go file. Subprogram A 
contains an imbedded call for subprogram D, which 
has already been processed. Subprogram B contains 



an imbedded call for subprogram C, which is on a 
Library named mylib on the System Operating File. 
The fourth operand of the exeq linkload card desig- 
nates mylib as the System Library file for this Linkage 
Loader run. The Linkage Loader, when it processes 
subprogram B, puts subprogram C on the request list. 
Because no more Linkage Loader control cards exist, 
the Linkage Loader then calls in subprogram C from 
the Library. 

The memory map for these subprograms, which 
form program xyz, will be: 



D 


A 


B 


C 
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Note that A was before B on the Go file, because A 
was compiled before B. 

The Linkage Loader puts program xyz, in absolute 
format, on the Job file. If the installation wants to keep 
using this program in absolute format, the operator 
should save the Job file tape reel after the program is 
executed. This reel can later be mounted on a physical 
unit that has been assigned to the Job file. 

When the Linkage Loader is finished, it returns con- 
trol to the Resident Monitor, which brings in the 
Transitional Monitor. The Transitional Monitor reads 
the mode card. Because two of the subprograms are 
newly compiled, mode test is specified before the 
program is executed. The last subprogram to be exe- 
cuted ends with b /uep/ in order to return control to 
the Resident Monitor's End-of-Program routine at the 
/uep/ entry point. 

When the Transitional Monitor reads the exeq xyz 
card, it repeats the procedure used to bring in the 
language processors and Linkage Loaders, except that 
it loads phase 001, named xyz, from the Job file. Note 
that dependent programs, whether IBM-provided or 
user-written, are given the same processing by the 
System Monitor. 

In this example, subprogram B was the primary sub- 
program. Therefore, processing control is initially 
given to the entry point for subprogram B. 

The program, during execution, reads input data 
from the Standard Input Unit through the Resident 
Monitor's Read routine. 

If the program fails, the operator gives control to 
the Resident Monitor's End-of-Program routine 
through the /uep/ entry point. If the program executes 
successfully, it also gives control to the /uep/ entry 
point. In either case, the End-of-Program routine will 
write the contents of storage on the Core Image file, 
and the Resident Monitor will bring in the Transitional 
Monitor. 

The Transitional Monitor, because the unusual end 
of program occurred in test mode, will read the 
Standard Input Unit for any Monitor control cards, 
rather than skipping to the next job card. If the pro- 
gram fails before all input data cards are read, the 
Transitional Monitor will skip past them and resume 
processing when it finds the first Monitor control card. 
Thus, the Transitional Monitor will read the exeq 
utilities card. It will bring the Utility programs into 
storage from the System Operating File in the same 
way it brought in the other dependent programs. 

When the Utility programs are finished, they will re- 
turn control to the Resident Monitor, which will bring 
in the Transitional Monitor. The Transitional Monitor, 
upon resuming reading from the Standard Input Unit, 
will read the job anyname card. It will close out the 



previous job, named example, and reset the Resident 
Monitor for the new job. 

The above example shows just one of the many job 
combinations that are possible. For example, the sub- 
programs compiled could form a user-written language 
processor. This new processor could be relocated by 
the Linkage Loader and executed to compile a pro- 
gram. The newly compiled program could then be re- 
located and executed. 

The example showed execution of only one program. 
The job could have included execution of many pro- 
grams. 

Example 2 

The following example shows the complete control 
card deck for a batch. The machine configuration for 
this example is shown in Figure 15. Figure 16 illus- 
trates the control card deck for this example. Figure 
17 presents a chart of input/output assignments as they 
are made from the asgn cards in the control card deck. 
The following comments give information concern- 
ing the makeup of the control card deck and explain 
the changing input/output assignments summarized in 
Figure 17. 

Cards 7-8 

These cards constitute the daily information for initial- 
ization of the System Monitor. In addition to supplying 
the current date, these cards assign input/output units 



Al has been assigned 
for the System Operating 
File, during System S_ 
Generation. The Li- 
brary is on the SOF, 
and therefore need not 
be assigned with an 
ASGN card. 




CI , the card reading function, has been 
assigned for the Standard Input Unit, during 
System Generation. C2 is the card punch 
function. 

Figure 15. Machine Configuration for Second Example 
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Figure 16. Sample Control Card Deck for Second Example 
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Units 


Initial- 
ization 


First 
Job 


Second Job 


Third Job 


Fourth 
Job 


Al 


SOF 


SOF 


SOF 


SOF 


SOF 


A2 


MWT 


MW1 

and 

MR! 


MW1 

and 

MJB 


1 . MW1 cancelled 

2. MR4 (base unit) 

3. MR4 cancelled 

4. MRB 


MW1 


A3 


MW2 


MW2 

and 

MR3 


MW2 

and 

MR8 


1. MW2 cancelled 

2. MR4 (alternate 

unit) 

3. MR4 cancelled 

4. MRC 


MW2 


Bl 


MDM 


MDM 


MDM 


MDM 


MDM 


B2 


MW3 


MW3 

and 

MR2 


1. MW3 

2. MW3 cancelled 

3. MR9 (base unit) 


MR5 
(base unit) 


MW3 


B3 


MW4 


MW4 

and 

MGO 


1 . MW4 and MGO 

2. MW4and MGO 
cancelled 

3. MR9 (alternate 

unit) 


MR5 
(alternate unit) 


MW4 


B4 


un- 
assigned 


MJB 


MR1 

source program 

tape for Autocoder 


MJB 
and 
MR A 


unas- 
signed 


CI 


SIU 


SIU 


SIU 


SIU 


SIU 


C2 


SPU 


SPU 


SPU 


SPU 


SPU 


C3 


SPR 


SPR 


SPR 


SPR 


SPR 



Figure 17. Assignments of Input/Output Units for 
Second Example 



Cards 39-53 

These cards define the third job. This job consists of 
the execution of the Linkage Loader to combine two 
subprograms from the Library, the execution of the 
resulting program, and then the execution of one of 
the installation's programs contained on the System 
Operating File. 

Cards 40 and 41 cancel the assignment of two Work 
files to permit A2 and A3 to be used as base and alter- 
nate Reserve files. Note that the assignment made by 
card 43 is permissible because the last effective assign- 
ment for B2 and B3 was for a Reserve file, and that 
assignment was automatically canceled between jobs. 
Card 50 cancels the assignment made by card 42, per- 
mitting as and A3 to be used as base units for the next 
program within the job. 

Cards 54-60 

These cards define the fourth and last job in the batch. 
This job consists of a single compilation. It is included 
in the sample batch to illustrate the need for recording 
the changing input/output assignments, so that can- 
celed assignments for symbolic units can be restored 
when those symbolic units are again required. In this 
job, the four Work files assigned during initialization 
must be assigned again, since during the course of the 
preceding jobs, all the Work file assignments have been 
canceled (cards 32, 33, 40, and 41). 



for the Standard Print Unit, the Standard Punch Unit, 
the Core Image file, and the language processors' 
Work files. 

Cards 9-20 

These cards define the first job of the batch. The job 
consists of a compile-and-go operation for a single 
subprogram. 

Cards 27-38 

These cards define the second job. This job consists of 
a compile-and-go operation for a single subprogram to 
be tested. The Snapshot program is to be incorporated 
into the subprogram. The Storage Print and Tape 
Print programs are to be executed after execution of 
the subprogram. Note that for the compilation, the 
source statements are to be mounted on tape physical 
unit B4. Also note that the test program will use tape 
physical units bs and B3 as base and alternate Reserve 
files. Since B2 and B3 have been previously assigned as 
base units only, the previous assignments must be 
canceled. 



Restarting from a Checkpoint 

The System Monitor provides facilities to restart cer- 
tain programs that were discontinued because of 
certain error conditions recognized by the operator or 
because a program of higher priority, to be loaded 
from the Alternate Input Unit, required the machine. 
Also, the processing of some programs requires so 
much time that the processing is performed in install- 
ments. 

Note: Only programs that request checkpoints on 
the Core Image file can use the restart facilities of the 
System Monitor. (See "System File Sharing and De- 
vice Switching Feature.") 

The operator discontinues programs (that have 
taken checkpoints and will be restarted ) by using the 
$10 or $3x console inquiry. The $3x inquiry can be 
used only if the program recognizes it as a request to 
discontinue at some convenient point (checkpoints 
were taken previously ) or as a request to take a check- 
point and then discontinue. 

Restarting is described in detail in the Operators 
Guide publication. 
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Immediate and Delayed Restarts 

The Resident iocs provides a routine for writing check- 
point records on the Core Image file. (See the Basic 
Input/Output Control System publication for details 
concerning the creation of checkpoint records.) These 
records consist of the information in core storage at the 
time the checkpoint is taken. From these records the 
System Monitor can restart a program in one of two 
ways: 

Immediate Restart: An immediate restart can be 
effected by entering the $70 message through the con- 
sole printer. This message causes the Resident Monitor 
to bring the Transitional Monitor into storage. The 
Transitional Monitor then executes a Restart routine, 
which locates the most recent checkpoint on the Core 
Image file and initiates a restart of the dependent pro- 
gram from that checkpoint. The major functions per- 
formed for the immediate restart are as follows: 

1. Reloading the dependent program into core 
storage. 

2. Restoring areas of the Resident Monitor related 
to the status of the dependent program at the time the 
checkpoint was taken. 

3. Repositioning the necessary system tape files and 
all the user's tape files that were open at the time the 
checkpoint was taken. 

Notes: (1) The Standard Print and Punch Units, if 
assigned to the same tape unit, are not repositioned 
during a restart. (2) If the variable print and punch 
modules have been selected during System Genera- 
tion, and if the Standard Print Unit, Standard Punch 
Unit, and Core Image file are on the same tape unit, 
that unit will be repositioned to a point just beyond 
the checkpoint taken. 

4. Resuming execution of the dependent program at 
the point at which the checkpoint was taken. 

Delayed Restart: A delayed restart is effected by 
initialization of the System Monitor. At the time of an 



initialization for the purpose of a delayed restart, the 
operator supplies control information specifying the 
particular checkpoint from which the dependent pro- 
gram is to be restarted. ( Note the difference from the 
immediate restart, which uses only the most recent 
checkpoint. ) 

The functions performed for the dependent program 
during a delayed restart are essentially the same as 
those performed during an immediate restart. Care 
must be exercised, however, that the configuration at 
the time the checkpoint was taken is duplicated for the 
restart procedures. 



Restart Conditions 

The following considerations apply to programs using 
the checkpoint and restart facilities of the System 
Monitor: 

1. No repositioning can be performed for unit- 
record equipment. 

2. After the checkpoint is requested, the restart 
procedure cannot restore disk records that have been 
changed. Therefore, programs that update records in 
disk storage cannot be effectively restarted if the 
checkpoint is requested after processing of the records 
has begun. 

3. Tape files that are closed at the time of a check- 
point cannot be repositioned during a restart from 
that checkpoint. (This is no problem if the tape file 
was rewound when it was closed. ) 

4. Programs operating under control of the Tele- 
processing Supervisor cannot use the checkpoint and 
restart facilities. 

5. If the Core Image file and the Temporary Stor- 
age file share the same tape unit, immediate restart 
cannot be used if the tp complex is open. A delayed 
restart must be used instead. (Before the delayed re- 
start is processed, the tp complex is closed. ) 
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Where more than one page reference is given, the major 
reference appears first. 

Absolute addresses 6,23 

Absolute format 6,11 

Absolute Zero 14 

Actual Addresses 21 

Addresses 

Absolute 6, 23 

Actual 21 

Load 14, 65 

Relocatable 6,25 

Alternate input unit (aiu) 12,45,68 

Alternate unit 43,52 

/ams/ 27,45 

Arithmetic overflow indicator 42 

asgn card 52,44,46,53,68 

Assignment cancellation 53,43 

Assignment routines 50,10 

Assignment of input/output units 50 

Autocoder 41, 8, 11, 14, 15, 25, 26, 27, 28, 29, 30, 37 

Backspace system tape subroutine 38 

baseI card 21,16,56,64,66 

base2 card 24,16,27,56,64,66 

Base Zero 14,21 

Batch processing 7 

Bootstrap routine 12,60,68 

call card 15,16,18,19,20 

calln card 19, 15, 16 

callp card 20,15,16 

Calls 15, 9, 19, 20, 64, 66 

Imbedded 15,7,8,11,19,64 

Unresolved 9 

Cancellation of assignment 53,43 

Card 12 

Card image format 12 

Carriage-control character 35,36 

/cgo/ 40,43 

chain control cards 

comn 28,29,66 

end 28,29,66 

entry 29,66 

exeq linkload 28 

LINK 28,66 

chain feature 26,11 

chain programs, execution 29 

chain subroutine 29 

Chaining cobol 27, 30 

Chaining Fortran 30 

Channel status character 34,37,39 

Checkpoint 72, 13 

Class A messages 62 

Class B messages 62 

Class C messages 63 

Clear Storage card 66 

Clear Word Mark card 67 

cobol, title card 26 

cobol, chaining 27, 30 

COBOL COMMON 27 

Common data area 14,24,26 

Communication region 31,11,46 

/ams/ 34 

/cgo/ 34 



/CRD/ ..; 34 

/DAT/ 34 

/ipi/ 31,34,43 

/lin/ :.... 34 

/mci/ 34 

/mga/ 34 

/org/ 34 

/phn/ 34,43 

/phm/ 34,43 

/siz/ 34,43 

/tpb/ 34 

Communication symbol 8,9 

Compile-and-go operation 7,43,53 

comt card 46 

congo card 26 

Console inquiries 61,7 

Class A messages 62 

$10 62,72 

$20 62 

$3x 62,36 

$50 62,36 

$70 62 

$8x 62 

$90b (any input up to 16 characters) 62 

Class B messages 62 

$B1 62 

$B2 62 

$B3 62 

$B4 62 

$B5ss 62 

$B6ss 62 

$B7bxxyyb 62,47 

$B7bxxyynnnnnnnnnnb 63, 47 

$B7Bxxyynnnnnnnnnnb 63, 47 

$B7Uxxyynnnnnnnnnnb 63, 47 

$B7Rxxyy 63 

$BX 63 

Class C messages 63 

$Clss 63 

Console Inquiry routine 11,36 

Control cards 

chain 28 

Linkage loader 15 

Monitor 43 

Control card interpretation routine 11 

Core exceeded 26 

Core image file 13,40 

/CRD/ 34 

Daily information 68,46,53 

date card 46,68 

/DAT/ 46 

dcwf card 8,15,18 

dcws card 8, 15, 18 

defin card 65 

Define the File statement 50 

Dependent link 27 

Dependent programs 41 

Device switching feature for spr, spu 53 

Diagnostic messages 56, 13 

disgo card 26 

Divide Overflow indicator 42 

end card '46 

end card for chained programs 29 
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End of file 25 

End of program 39,45 

End-of -program routine 39 

Normal end of program 39 

Special end of program 40 

Unusual end of program 39 

End of reel 52 

End of unit 52 

end statement 7 

entry card 29,66 

Entry point 8 

/eop/ 39,27,40 

Errors 13, 36, 38 

Error checking 10 

exeq card 45,28 

Format 

Absolute 6, 11 

Card-image 12 

Relocatable 64,6 

FORTRAN, TITLE Card 25 

Fortran, Chaining 30 

Go file 13,11,26,43,53 

go mode 43 

Halts, programmed 41 

Header record 21 

ibaccount module 43 

iblookm routine 55 

IBMLIBR 45 

Imbedded calls 15,7,8,11,19,64 

Index registers 41,49 

Initial entry point of subprograms 7 

Initialization messages 59 

Initialization of resident monitor 68,46 

Initialization routine 68,11 

Initialization of spool 47 

input card 25 

Input/output control system 10 

Input/output files 12 

/ipi/ 31,34,43 

iocs 34 

ioctl 36 

Job 7,43,51 

job card 43 

Job file 13, 10 

Job routine 11 

Language processors 6,12,13,14,68 

Autocoder 26,27,28,30 

cobol 26,27,28,30 

Fortran 26, 27, 28, 30 

lib 51,53 

Library 12,25,45 

/lin/ 34 

Link, dependent 27 

Link, main 27 

link card 28 

Linkage Loader 

General 6,8,9, 10,45 

Functions 11,56,69 

Use 14 

Linkage loader control cards 15, 7 

Coded by programmers 

baseI card 21,16,56,64,66 

base2 card 24, 16, 27, 56, 64, 66 

call card 15,16,18,19,20 

calln card 19,15,16 

callp card 20, 15, 16 

congo card 26 

defin card 65 



disgo card 26 

input card 25 

phase card 20,16,21,24,56 

prtct card 23,21,56,66 

snap card 24, 17 

Produced by language processors 

Clear Storage card 66 

Clear Word Mark card 67 

Load card 64 

Random Load card 66 

Set Word Mark or Record Mark card 67 

Termination card 64 

title card 25,7,16,18,21,56,64 

Linkage sequence 55,7,31,32 

to Backspace System Tape subroutine 38,32 

to Console Inquiry routine 36,32 

to End-of-Program routine 39,33 

to iblookm routine 55 

to load routine 37,32 

to Modification of Communication Region routine .... 31,32 

to Print routine 35,32 

to Punch routine 36,32 

to Read routine 34,32 

to Read System Disk subroutine 38,32 

to Read System Tape subroutine 37,32 

to Rewind System Tape subroutine 38,32 

to Simple Search subroutine (tape or disk) 38,32 

to Wait-Loop subroutine 36,32 

Linkage symbol 8,18,21,23,25,64 

Load address 14,65 

Load card 64 

Load routine 37,32 

/lod/ 37 

Main. Link 27 

/mbf/ 38 

/mbx/ 38 

/mci/ 34,36 

/mcr/ 36,40 

/mcs/ 34 

mdm 13, 51, 53, 54, 55 

mdt 13, 51, 53 

Memory map 56,15 

Messages 

Bootstrap routine messages 

bootstrap error 01 60 

bootstrap error 02 60 

bootstrap error 03 60 

bootstrap error 04 ... 60 

bootstrap error 05 60 

bootstrap error 06 60 

bootstrap error 07 60 

00202 60 

00438 60 

Diagnostic messages for programmers 
uepx 56 

00501 sof directory not found 57 

00502 mjb directory not found 57 

00503 invalid directory record 57 

00504 siu/aiu SWITCH FAILED 57 

10520 cgo-ll 57 

10521 cgo-mjb 57 

10522 Istopinv 57 

10522 2nd op inv 57 

10522 3rdopinv 57 

10523 no aiu 57 

10524 aiu active 57 

10525 chg ttttt 57 

10526 chg unasgn 57 

10527 chg inv 57 

10529 go dsk exc 57 
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10530 NOT FOUND 57 

10531 NOT FOUND IN SOF DIRECTORY 57 

10532 INCOMPATIBILITY IN BLOCK COUNTS 57 

10535 MJB INVALID LOC 58 

Initialization messages 

DATE NOT ENTERED 59 

ENTER ASGN FOB MDM 59 

ENTER ASGN FOR MDM AND MDT 59 

ENTER DATE, I/O ASSIGNMENTS, JOB NUMBERS 59 

ENTER JOB NUMBERS 59 

ENTER RST NUMBER 60 

ENTER SOF/SIU ASGN SYMB 60 

EOF Snj/AIU IN INIT 60 

INIT ASGN EXCEED TABLE 60 

( asgn card image) invalid assignment 60 

INV INITIAL CHAR 59 

IOOR JN 59 

IO OR JN RE ENTER XXX 59 

JOB SEARCH OUT OF STEP 60 

MUST ENTER SOF/SIU ASGN SYMB 59 

SHARE VIOLATION, MONITOR COMPILATION 60 

Linkage loader diagnostic messages 

INPUT CARD INVALID 6 

SOF LIBRARY NAME UNEQUAL TO EXEQ CARD 6 

/LIB/ HEADER NAME UNEQUAL TO EXEQ CARD 6 

***** bad indicator (card contents) 6 

***** bad input card (card contents) 6 

***** bad load addr (card contents) 6 

***** core exceeded (card contents) 6 

*****DUFLDEFIN 6 

***** END OF FILE INDICATOR WHILE ATTEMPTING TO 

PROCESS LIBRARY 6 

***** error (card contents) 6 

***** FrflST LIB REC NOT DIR 6 

***** JOB FILE NOT CREATED 6 

***** snap ignored (card contents) 6 

***** symbol undefined ( card contents) 6 

***** TABLE OVERFLOW 6 

***** UNRESOLVED ENTRIES 6 

***** UNRESOLVED ENTRIES NONE 6 

Messages for operators 

asgn op invalid xnn 58 

END AIU 58 

END SIU 58 

INV A MSG 58 

SWITCH TO NEXT SIU W/O INITIALIZATION 58 

10101 mms 58,48 

10103cPTnnx 58 

10104 rep inq 58 

10190 xx 58,47 

| 10191 nnnnnnnnnn 58,47 

10192 sip 58,48 

10199 eosn 59,48 

enter b messages 58 

20502 sub for ss 59 

20503 INV at end situation 59 

INV B INQ 59 

30101 cu 59,48 

Messages during restart 

10128 SPU-SPR SAME UNIT 60 

10133 siu u/r 60 

10134 aiu u/r 60 

/mga/ 34 

mgo 13, 51 

mjb 13, 51 

MLT 13, 51 

mode card 43 

Modification of Communication Region routine 3 1 , 32 

Monitor control cards 43, 7 

asgn card 52,44,46,53,68 



coMTcard 46 

date card , 46, 68 

end card ■ 46 

exeq card 45, 28 

job card 43 

mode card 43 

monop 31 

mon$$ (see monitor control cards) 15 

Multiphase programs 20,8,18,19,26 

Name, program 20 

Normal end of program 39 

/org/ 34 

Organization of programs 18 

Origin point of subprogram 14 

Overlay 14,27,37,45 

Patches 64, 12, 20 

pause card 46 

/pch/ 36 

Phase 7,14,18,19,20 

phase card 20, 16, 21, 23, 24 

Phase number 20 

/phn/ 34,37,43 

Physical unit 50,47,25,43 

Alternate 52,53 

Base 52 

/pnm/ 34,37,43 

pow program 13 

Print routine 35,36 

Priority Alert mode 41 

"Priority On" switch 41 

"Priority Select" switch 41 

Program construction 7 

/prt/ 35 

prtct card 23,21,56,66 

Punch routine 36 

Random Load card 66 

Read error logging 13 

Read routine ■• 31,34 

Read System Disk subroutine 38,32 

Read System Tape subroutine 37,32 

Reinitialization 51 

Relocatable address 6,25 

Relocatable format 64,6 

Relocation 14 

Downward 14 

no 14 

Upward 14 

Relocation indicators 64,65 

Request list, linkage loader 15, 18 

Resident iocs 41,10,34,39,49,73 

Resident monitor 6,10,25,70,73 

Functions 10 

Use of 31,68 

Restart 72,13,73 

Rewind System Tape subroutine 38,32 

/riq/ 36 

Run 7 

Set Word Mark or Record Mark card 67 

sg mode 43 

Shared system files 53 

Sharing 53 

Simple Search subroutine (tape or disk) 38,32 

Simultaneous Peripheral Operation on Line (spool) 47 

siu 12,51 

/siz/ field 41,34,43 

snap card 24,17 

Snapshots 24,12,25 

sof 12,51,53 
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Sort Definition program 12 

Source language 7 

Source statements 45 

Special end of program 40,10 

spend statement 7 

spool card 46 

spool editing routines 48 

spool files 47,12 

sul and su2 12 

stI and st2 12 

spool initiation 47 

spool initialization 47 

spool messages 

10101 mms xx 48 

10190 xx ".!! 47 

t 10191 nnnnnnnnnn 47 

10192sip 48 

10199Eosn 48 

30101 cu 48 

spool operation 47 

spR 12,51,53 

spu 13,51,53 

Standard input unit (siu) 12,11,25,41,45,46,68 

Standard print unit (spr) 12,51,53 

Standard punch unit (spu) 13,51,53 

stdio 34' 36 

Subprogram 7, 14, 26 

Symbolic names for symbolic units 51 

Symbolic unit 51,25,52,53 

Symbol table, linkage loader 8,15,18 

symunit entry 50,52 

sysio 38' 39 

System files 12,11,51,53 

Alternate input unit (aiu) 12,11,45,68 

Core image file (mdm) 13,40 

go file (mgo) 13,11,26,43,53 

job file (mjb) 13,10 

Standard input unit (sru) 12,11,25,41,45,46,68 

Standard print unit (spr) 12,51,53 

Standard punch unit (spu) 13,51,53 

System library file (lib) 51,53 

System operating file (sof) 12 

Temporary storage file (mdt) 51,53 

TP library file (mlt) 51,53 

System generation 10, 12, 13,36,43,47,52 

System generator file 45 

System library file 51, 53 

System monitor 

Concepts 6 

Functions 10, 68 

Initialization 68 

Operation 68, 6 

Purpose 5 



Use of 7 

System operating file 12 

System symbols 8 34 

/ EOp / 39727,' 40 

/lod/ ; 37 

/mbf/ 38 

/mbx/ 38 

/mcr/ 36,40 

/mcs/ 34 

/pen/ """"""! 36 

/*wr/ 35 

/MQ/ 36 

/rsi/ 34 

/uep/ ...., 3g 

/WAT/ 37 

/zbs/ 38 

/ZRR/ 37 

/ZRS/ 38 

/zrw/ 38 

/zss/ 38 

System regeneration 42 

Tele-processing devices 52 

Tele-processing system 14,36,40,46,53,73 

Tele-processing system files (MTx) 51,53 

Temporary Storage file (mdt) 13,51,53 

Termination cards 7,64 

Termination record 20 

Testing programs 6,40,43,44 

test mode 43,44 

title card 25, 7, 16, 18, 21, 5M4 

/TPB/ 34 

tp library file 13,51,53 

Transitional monitor 43 

General 43, 6, 10, 13, 41, 68 

Functions n 10 

Use of 43 

/uep/ , 39 

Unit-record interrupts , 41 

Unit-record routines 10,31 

Unusual end of program 39 

Utility programs 40,45 

Variable module 54,13 

Wait-Loop routine 11,36,37 

/WAT/ 37 

Word separator character 41,64 

Work files (MWx) 12, 51, 53' 68 

/zbs/ 38 

/zrr/ 37 

/zrs/ 38 

/zrw/ 38 

/zss/ 38 
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